Phoenixd MCP Server

Name: Phoenixd MCP Server
Author: Sharmaz

@Sharmaz

Repository

About Phoenixd MCP Server

Connect a phoenixd bitcoin lightning wallet to your LLM.

#phoenixd #lightning #bitcoin

Basic information

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>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from Phoenixd MCP Server

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.

Is the `create-offer` tool functional?

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

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.

What authentication does the server use?

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

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

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