README.md
Give any AI agent Bitcoin superpowers
bitcoin-mcp
Give any AI agent Bitcoin superpowers — fee intelligence, mempool analysis, and 49 tools. Zero config, one command.
49 tools · 116 tests · 6 prompts · 7 resources · Zero config · MIT licensed
If bitcoin-mcp is useful to you, consider giving it a star — it helps others discover the project.
pip install bitcoin-mcp
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"bitcoin": {
"command": "uvx",
"args": ["bitcoin-mcp"]
}
}
}
Claude Code
claude mcp add bitcoin -- uvx bitcoin-mcp
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"bitcoin": {
"command": "uvx",
"args": ["bitcoin-mcp"]
}
}
}
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"bitcoin": {
"command": "uvx",
"args": ["bitcoin-mcp"]
}
}
}
Docker
docker build -t bitcoin-mcp .
docker run -i bitcoin-mcp
Or with docker compose:
docker compose up
Pass environment variables to connect to a local Bitcoin Core node or set your API key:
docker run -i -e SATOSHI_API_KEY=your-key bitcoin-mcp
Why bitcoin-mcp?
- Fee intelligence that saves real money — know the cheapest time to send, compare fee tiers, estimate exact costs before broadcasting
- Zero config — works instantly with the free hosted Satoshi API, or connect your own Bitcoin Core node
- First Bitcoin MCP server on the Anthropic Registry
Top Use Cases
Ask your AI agent:
| Prompt | What it does |
|---|---|
| "What's the cheapest time to send Bitcoin today?" | Fee recommendation with savings breakdown |
| "Analyze the current mempool congestion" | Real-time mempool depth, fee tiers, pending tx count |
| "How much would I save waiting 6 blocks vs next block?" | Side-by-side fee comparison across confirmation targets |
| "Search for this transaction: abc123..." | Full transaction decode with inscription detection |
| "Give me a situation summary of Bitcoin right now" | Price, fees, mempool, mining, difficulty — one call |
Full Tool Reference
All 49 tools by category
Fee Intelligence
| Tool | Description |
|---|---|
get_fee_recommendation |
Optimal fee rate with urgency tiers and savings tips |
get_fee_estimates |
Fee estimates across all confirmation targets |
estimate_smart_fee |
Fee estimate for a specific confirmation target |
compare_fee_estimates |
Side-by-side comparison of fee sources |
estimate_transaction_cost |
Exact cost estimate for a transaction before sending |
Blocks & Transactions
| Tool | Description |
|---|---|
analyze_block |
Deep analysis of any block by height or hash |
get_block_stats |
Statistical breakdown of a block |
get_block_count |
Current chain height |
compare_blocks |
Compare two blocks side by side |
search_blocks |
Search a range of blocks |
analyze_transaction |
Full transaction analysis with inscription detection |
decode_raw_transaction |
Decode a raw transaction hex |
send_raw_transaction |
Broadcast a signed transaction |
check_utxo |
Check if a UTXO is spent or unspent |
Mempool
| Tool | Description |
|---|---|
analyze_mempool |
Full mempool analysis — depth, fees, congestion |
get_mempool_info |
Mempool size, bytes, fee floor |
get_mempool_entry |
Details for a specific unconfirmed transaction |
get_mempool_ancestors |
Ancestor chain for a mempool transaction |
Mining
| Tool | Description |
|---|---|
get_mining_info |
Current mining difficulty, hashrate, block reward |
analyze_next_block |
Preview of the next block template |
get_mining_pool_rankings |
Top mining pools by recent blocks |
get_difficulty_adjustment |
Time |
Tools (22)
get_fee_recommendationOptimal fee rate with urgency tiers and savings tipsget_fee_estimatesFee estimates across all confirmation targetsestimate_smart_feeFee estimate for a specific confirmation targetcompare_fee_estimatesSide-by-side comparison of fee sourcesestimate_transaction_costExact cost estimate for a transaction before sendinganalyze_blockDeep analysis of any block by height or hashget_block_statsStatistical breakdown of a blockget_block_countCurrent chain heightcompare_blocksCompare two blocks side by sidesearch_blocksSearch a range of blocksanalyze_transactionFull transaction analysis with inscription detectiondecode_raw_transactionDecode a raw transaction hexsend_raw_transactionBroadcast a signed transactioncheck_utxoCheck if a UTXO is spent or unspentanalyze_mempoolFull mempool analysis — depth, fees, congestionget_mempool_infoMempool size, bytes, fee floorget_mempool_entryDetails for a specific unconfirmed transactionget_mempool_ancestorsAncestor chain for a mempool transactionget_mining_infoCurrent mining difficulty, hashrate, block rewardanalyze_next_blockPreview of the next block templateget_mining_pool_rankingsTop mining pools by recent blocksget_difficulty_adjustmentTime until next difficulty adjustmentEnvironment Variables
SATOSHI_API_KEYAPI key for Satoshi API if not using defaultConfiguration
claude_desktop_config.json
{"mcpServers": {"bitcoin": {"command": "uvx", "args": ["bitcoin-mcp"]}}}Try it
→What's the cheapest time to send Bitcoin today?
→Analyze the current mempool congestion
→How much would I save waiting 6 blocks vs next block?
→Search for this transaction: abc123...
→Give me a situation summary of Bitcoin right now