Phoenixd MCP Server

Connect a phoenixd bitcoin lightning wallet to your LLM.

Local serverstdio

What is the Phoenixd MCP Server?

Phoenixd MCP Server is an MCP project maintained in the sharmaz/phoenixd-mcp-server repository. The maintainer describes its purpose as “Connect a phoenixd bitcoin lightning wallet to your LLM”. Read the project documentation for the complete scope.

Installation

The documented npm package is phoenixd-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares HTTP_PROTOCOL, HTTP_HOST, HTTP_PORT, HTTP_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
create-invoiceCreate a bolt11 invoice with a specified amount and description.
Inputs:offer (string): The bolt12 offer to decode.
descriptionHashstring, optional): SHA256 hash of the description. Use instead of description.
amountSatnumber): Amount to send in satoshis.
expirySecondsnumber, optional): The offer expiry in seconds.
externalIdstring, optional): External id of the payment.
webhookUrlstring, optional): A URL that phoenixd will POST to when this invoice is paid. The payload is a JSON object with the payment details as defined in the Phoenixd
create-offerCreate a bolt12 offer.
pay-invoicePay a bolt11 invoice.
sendAllboolean, optional): If true, empties the wallet. Mutually exclusive with amountSat.
pay-offerPay a bolt12 offer.
messagestring, optional): Optional message to include with the payment.
pay-lightning-addressPay a Lightning Address.
pay-on-chainSend an on-chain Bitcoin payment.
feerateSatBytenumber): The fee rate in satoshis per byte.
bump-feeBumps the fee rate of all unconfirmed on-chain transactions using CPFP. Returns the ID of the child transaction.
list-incoming-paymentsList incoming payments (invoices).
tostring, optional): End timestamp in millis from epoch, default now.
limitnumber, optional): Number of payments per page, default 20.
offsetnumber, optional): Page offset, default 0.
allboolean, optional): Also return unpaid invoices, default false.
get-incoming-paymentGet details of a specific incoming payment (invoice).
list-outgoing-paymentsList outgoing payments.
get-outgoing-paymentGet details of a specific outgoing payment.
get-node-infoGet the node info.
Inputsnone
get-balanceGet the balance of the node.
list-channelsList the node channels.
close-channelClose a channel by ID, sending the funds to a specified address on chain, with a specified fee rate.
addressstring): The Bitcoin on chain address to send the funds to.
decode-invoiceDecode a bolt11 invoice, the output amount is in millisatoshis.
decode-offerDecode a bolt12 offer, the output amount is in millisatoshis.

How to install the Phoenixd MCP Server

{
  "mcpServers": {
    "phoenixd-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "phoenixd-mcp-server"
      ],
      "env": {
        "HTTP_PROTOCOL": "http",
        "HTTP_HOST": "127.0.0.1",
        "HTTP_PORT": "9740",
        "HTTP_PASSWORD": "YOUR_HTTP_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HTTP_PROTOCOLDeclared in the maintainer’s client configuration.Check documentation
HTTP_HOSTDeclared in the maintainer’s client configuration.Check documentation
HTTP_PORTDeclared in the maintainer’s client configuration.Check documentation
HTTP_PASSWORDDeclared in the maintainer’s client configuration.Check documentation