Bitcoin MCP — Claude Code MCP server: features and setup
Bitcoin MCP is an MCP server for Claude Code that gives an agent tools to inspect Bitcoin fees, the mempool, blocks, and transactions. It connects to a local Bitcoin Core/Knots node or a compatible API.
MIT ★ 5 updated 2026-11-03
claude mcp add --env BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> --env BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> --env BITCOIN_NETWORK=<BITCOIN_NETWORK> --env SATOSHI_API_URL=<SATOSHI_API_URL> --env SATOSHI_API_KEY=<SATOSHI_API_KEY> --transport stdio bitcoin-mcp -- uvx bitcoin-mcpWhat Bitcoin MCP does
Bitcoin MCP gives an agent tools for fee estimates and Bitcoin network data. It can compare transaction costs across confirmation targets, inspect mempool congestion, look up transactions, and retrieve block or mining details.
The server needs a data source: a local Bitcoin Core/Knots node with RPC settings, or a compatible API configured through SATOSHI_API_URL; the API may also require SATOSHI_API_KEY. Local node connections use BITCOIN_RPC_HOST and BITCOIN_RPC_PORT, with optional credentials or a data directory. The public Satoshi API at bitcoinsapi.com is paused and should not be used as a working default.
What it helps with
- estimate a Bitcoin transaction fee before sending
- compare costs for different confirmation targets
- inspect mempool congestion and fee levels
- look up and analyze a transaction
- retrieve a snapshot of Bitcoin fees, blocks, and mining
Example prompts for the agent
- Estimate the fee for sending Bitcoin now and compare it with waiting for confirmation.
- Inspect current mempool congestion and report the fee levels.
- Look up and analyze this transaction:
abc123...
How to install Bitcoin MCP
Platform CLI
claude mcp add --env BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> --env BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> --env BITCOIN_NETWORK=<BITCOIN_NETWORK> --env SATOSHI_API_URL=<SATOSHI_API_URL> --env SATOSHI_API_KEY=<SATOSHI_API_KEY> --transport stdio bitcoin-mcp -- uvx bitcoin-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>
Platform CLI
codex mcp add bitcoin-mcp --env BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> --env BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> --env BITCOIN_NETWORK=<BITCOIN_NETWORK> --env SATOSHI_API_URL=<SATOSHI_API_URL> --env SATOSHI_API_KEY=<SATOSHI_API_KEY> -- uvx bitcoin-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>
Config file
{
"mcpServers": {
"bitcoin-mcp": {
"command": "uvx",
"args": [
"bitcoin-mcp"
],
"env": {
"BITCOIN_RPC_HOST": "<BITCOIN_RPC_HOST>",
"BITCOIN_RPC_PORT": "<BITCOIN_RPC_PORT>",
"BITCOIN_NETWORK": "<BITCOIN_NETWORK>",
"SATOSHI_API_URL": "<SATOSHI_API_URL>",
"SATOSHI_API_KEY": "<SATOSHI_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>
Config file
{
"servers": {
"bitcoin-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"bitcoin-mcp"
],
"env": {
"BITCOIN_RPC_HOST": "<BITCOIN_RPC_HOST>",
"BITCOIN_RPC_PORT": "<BITCOIN_RPC_PORT>",
"BITCOIN_NETWORK": "<BITCOIN_NETWORK>",
"SATOSHI_API_URL": "<SATOSHI_API_URL>",
"SATOSHI_API_KEY": "<SATOSHI_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>
Platform CLI
gemini mcp add -e BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> -e BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> -e BITCOIN_NETWORK=<BITCOIN_NETWORK> -e SATOSHI_API_URL=<SATOSHI_API_URL> -e SATOSHI_API_KEY=<SATOSHI_API_KEY> bitcoin-mcp uvx bitcoin-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Bitcoin MCP
How do I install Bitcoin MCP in Claude Code?
Run claude mcp add bitcoin-mcp -e SATOSHI_API_KEY=<SATOSHI_API_KEY> -- uvx bitcoin-mcp. The server also needs a local Bitcoin Core/Knots node or a compatible API.
What does Bitcoin MCP do?
It adds tools for checking Bitcoin fees, mempool activity, blocks, and transactions. It can also retrieve mining and price data.
What does Bitcoin MCP need to run?
Use a local Bitcoin Core/Knots node with RPC settings or a compatible API. API access uses SATOSHI_API_URL and, when required, SATOSHI_API_KEY; node connections use BITCOIN_RPC_HOST and BITCOIN_RPC_PORT.