Advertise
MCP.so
Sign In

Phoenixd MCP Server

@Sharmaz

Repository

Basic information

Category

Other

Transports

stdio

Author

Sharmaz

Submitted by

Ivan Robles

About Phoenixd MCP Server

Connect a phoenixd bitcoin lightning wallet to your LLM.

#phoenixd#lightning#bitcoin

Phoenixd MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "phoenixd-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "phoenixd-mcp-server"
      ],
      "env": {
        "HTTP_PROTOCOL": "<http or https>",
        "HTTP_HOST": "<your_host>",
        "HTTP_PORT": "<your_phoenixd_port>",
        "HTTP_PASSWORD": "<phoenixd_http_password>"
      }
    }
  }
}

Phoenixd MCP Server tools

17

Get the balance of the node

Get the node info

List the node channels

Close a channel by ID, sending the funds to a specified address on chain, with a specified fee rate

Decode an bolt11 invoice, the output amount is in milisatoshis

Decode an bolt12 offer the output amount is in milisatoshis

Create a bolt11 invoice with a specified amount and description

Pay a bolt11 invoice with a specified amount and description

Create a bolt12 offer with an optional description and amount

Pay a bolt12 offer

Pays an email-like Lightning address, either based on BIP-353 or LNURL

Pay an on-chain address with a specified amount and fee rate

Makes all your unconfirmed transactions use a higher fee rate, using CPFP. Returns the ID of the child transaction

List the incoming payments

Get the incoming payment by payment hash

List the outgoing payments

Get the outgoing payment by payment id

Overview

What is Phoenixd MCP Server?

Phoenixd MCP Server connects a phoenixd Bitcoin Lightning wallet to an LLM via the Model Context Protocol. It uses the MCP TypeScript SDK and the Phoenixd API, enabling AI assistants to manage Lightning payments and node operations programmatically.

How to use Phoenixd MCP Server?

Configure the server in claude_desktop_config.json using npx -y phoenixd-mcp-server and set the environment variables HTTP_PROTOCOL, HTTP_HOST, HTTP_PORT, and HTTP_PASSWORD. Once connected, the LLM can call any of the server’s tools to interact with the phoenixd wallet.

Key features of Phoenixd MCP Server

  • Create and manage Lightning invoices and offers
  • Send and receive Lightning, on‑chain, and Lightning Address payments
  • Query node balance, channels, and payment history
  • Decode invoices and offers for inspection
  • Bump fees for unconfirmed on‑chain transactions

Use cases of Phoenixd MCP Server

  • Allow an AI assistant to pay for services over Lightning
  • Automatically create invoices for e‑commerce checkouts
  • Monitor incoming payments and reconcile them with external IDs
  • Close channels and adjust node liquidity from an LLM

Frequently asked questions

1

What is needed to run the server?

A running phoenixd instance with its HTTP API enabled, and the environment variables `HTTP_PROTOCOL`, `HTTP_HOST`, `HTTP_PORT`, and `HTTP_PASSWORD` set correctly.

2

Is the `create-offer` tool functional?

No – the README explicitly marks `create-offer` as “[Not Available]”.

3

What are the default values for `HTTP_PROTOCOL` and `HTTP_PORT`?

`HTTP_PROTOCOL` defaults to `http`, and `HTTP_PORT` defaults to `9740` if not provided.

4

What authentication does the server use?

The server requires the `HTTP_PASSWORD` environment variable, which must match the phoenixd HTTP password.

5

Where does payment data live?

All payment and node data is managed by the phoenixd wallet itself; the MCP server only acts as a bridge between the LLM and the wallet’s HTTP API.

Comments

More Other MCP servers

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise