Bitcoin MCP Server

by bortlesboatio.github.Bortlesboat/bitcoin-mcpv0.5.1

Self-hosted Bitcoin Core tools: fee estimates, mempool analysis, mining pool rankings, market sentiment, block and transaction inspection and BTC price.

5Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained32d ago

Install Bitcoin MCP server

claude mcp add bitcoin -e SATOSHI_API_KEY='<satoshi-api-key>' -- uvx bitcoin-mcp

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ],
      "env": {
        "SATOSHI_API_KEY": "<satoshi-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ],
      "env": {
        "SATOSHI_API_KEY": "<satoshi-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "bitcoin": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ],
      "env": {
        "SATOSHI_API_KEY": "<satoshi-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": [
        "bitcoin-mcp"
      ],
      "env": {
        "SATOSHI_API_KEY": "<satoshi-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BITCOIN_RPC_HOST	—	—	Bitcoin Core RPC host (default: 127.0.0.1)
BITCOIN_RPC_PORT	—	—	Bitcoin Core RPC port (default: auto-selected by network)
BITCOIN_NETWORK	—	—	Bitcoin network: mainnet, testnet, signet, or regtest (default: mainnet). Sets default RPC port if BITCOIN_RPC_PORT is not set.
SATOSHI_API_URL	—	—	Override the default hosted API URL (default: https://bitcoinsapi.com). The hosted API is used automatically when no local node is detected.
SATOSHI_API_KEY	—	yes	API key for authenticated access to the hosted Satoshi API (get one free at POST /api/v1/register)

Freshness

Maintained — last maintenance signal 32d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-07 · 32d ago · GitHub
Latest release
2026-09-07 · 32d ago · GitHub · v0.5.2
Package published
no data · npm/PyPI
Registry entry updated
2026-03-21 · 7mo ago · official registry · v0.5.1

FAQ

›How do I install the Bitcoin MCP server in Claude Code?

Run: claude mcp add bitcoin -e SATOSHI_API_KEY='<satoshi-api-key>' -- uvx bitcoin-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Bitcoin require an API key?

Yes. It expects SATOSHI_API_KEY, of which 1 is a secret.

›Can I use Bitcoin as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Bitcoin in the official MCP registry?

Yes, as io.github.Bortlesboat/bitcoin-mcp.