Phoenixd MCP Server
@Sharmaz
About Phoenixd MCP Server
Connect a phoenixd bitcoin lightning wallet to your LLM.
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
17Get 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
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
ghidraMCP
LaurieWiredMCP Server for Ghidra
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Awesome Mlops
visengerA curated list of references for MLOps
Comments