Bitcoin MCP

bitcoin-mcp gives Claude, GPT, and other agents native Bitcoin tools.

Install one MCP server, then let agents read blocks, inspect transactions, estimate fees, and reason about Bitcoin without writing custom glue. Run against Satoshi API for zero-config hosted access or point it at your own Bitcoin Core node when you want full local control.

Open setup guide Browse API docs PyPI package

Fast to install

Install with pip install bitcoin-mcp and add it to Claude Desktop, Claude Code, Cursor, Windsurf, or any other MCP-compatible client.

Zero-config fallback

When no local node is configured, bitcoin-mcp can call the hosted Satoshi API directly so agents still have useful Bitcoin tools immediately.

Self-host when needed

The same MCP server can point at your own Bitcoin Core node if privacy, sovereignty, or unlimited local access matter more than convenience.

Quick start

pip install bitcoin-mcp

claude mcp add bitcoin -- bitcoin-mcp
{
  "mcpServers": {
    "bitcoin": {
      "command": "bitcoin-mcp"
    }
  }
}

The public registry ID is io.github.Bortlesboat/bitcoin-mcp. The machine-readable MCP server card lives at /.well-known/mcp/server-card.json, which is also linked from /llms.txt so agents and crawlers can discover the stack cleanly.

What agents get

Fee intelligence

Ask whether now is a good time to send Bitcoin, what fee band to use, and how much can be saved by waiting.

Transaction and block inspection

Look up txids, decode mempool state, inspect recent blocks, and pull structured Bitcoin Core data without hand-rolling RPC wrappers.

Hosted or local execution

Start with hosted Satoshi API, then graduate to your own node later without changing the agent-facing tool surface.

How it fits together

Satoshi API is the hosted Bitcoin API and x402 discovery surface. bitcoin-mcp is the agent-facing tool layer. That split keeps the MCP experience simple while still letting you choose between a hosted backend and a self-hosted node.

If you want the hosted path, start with the MCP setup guide and the interactive docs. If you want the self-hosted path, Satoshi API stays open source and self-hostable, so the same MCP workflows can move closer to your own infrastructure over time.

  • Best for Claude or GPT agents that need structured Bitcoin tools
  • Good fit for fee-aware wallets, alerting agents, and payment monitors
  • Works with Satoshi API now and your own Bitcoin Core node later

Start with the clean path

For most people, the fastest route is: install bitcoin-mcp, use the hosted Satoshi API, and keep the x402 quickstart handy for paid hero endpoints.

Setup bitcoin-mcp Read x402 quickstart Why fee intelligence matters