Bitcoin MCP

What AbdelStark/bitcoin-mcp MCP server does

AbdelStark/bitcoin-mcp MCP server gives MCP-compatible AI clients access to Bitcoin and Lightning Network functions. Its Bitcoin features cover key generation, address validation, raw transaction decoding, latest-block queries, and transaction lookups by TXID. It also includes Lightning-specific operations for reading BOLT11 invoices and paying invoices through an LNBits wallet.

The server is intended for agent workflows that need to inspect blockchain information or perform narrowly defined Bitcoin and Lightning actions through tool calls. It does not present itself as a general-purpose wallet or a full node interface in the supplied documentation.

How it works

An MCP client starts the server and communicates with it through the Model Context Protocol. The README shows a local stdio configuration for Claude Desktop that runs the published bitcoin-mcp npm package with npx. Goose is also documented as a supported client, with both local command-line and remote SSE integration modes described in the project material.

For read-oriented Bitcoin tasks, the available tools can return information about the latest block, retrieve transaction details using a transaction ID, decode raw transaction data, or validate an address. Key generation returns a Bitcoin address, public key, and private key in WIF format. Lightning tools parse BOLT11 invoice data and can submit a payment using an LNBits wallet.

Setup and configuration

The documented Claude Desktop setup uses this MCP configuration:

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}

After adding the entry to Claude Desktop's configuration file, restart the application so it launches the server. The README identifies platform-specific configuration paths for macOS and Windows. It also documents Goose setup as either a local command-line extension or a remote SSE extension.

Lightning configuration is described as optional in the development setup, but the supplied material does not specify the required variable names or credential format. The payment capability should therefore be configured using the project's current documentation before use.

Tools and capabilities

• Generate Bitcoin key pairs, including address, public key, and WIF private key.
• Check whether a Bitcoin address is valid.
• Decode raw Bitcoin transactions into human-readable details.
• Retrieve the latest Bitcoin block and its metadata.
• Look up transaction details by TXID.
• Decode BOLT11 Lightning invoices.
• Pay Lightning invoices from an LNBits wallet.

AbdelStark/bitcoin-mcp MCP server can be tested from Claude Desktop with questions about the latest block or a transaction identified by its TXID. The response should come from the connected MCP tools rather than from a generic model answer.