
Bitcoin MCP
Plugs your AI agent directly into Bitcoin through the Satoshi API or your own node. Get smart fee recommendations, analyze mempool congestion, decode transactions with inscription detection, track mining difficulty and hashrate, and check address balances. The 49 tools cover everything from estimating exact transaction costs before broadcast to comparing fee tiers across confirmation targets. Zero configuration to start with the hosted API, and you can switch to local Bitcoin Core when you need it. Includes prebuilt prompts like "should I send this transaction now or wait" that call the fee intelligence tools and give you a clear answer with savings breakdowns.
- GitHub stars
- 2
- tools
- 51
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Mar 21, 2026
Tools
51 toolsPublic tool metadata for what this MCP can expose to an agent.
get_fee_recommendationOptimal fee rate with urgency tiers and savings tips
Optimal fee rate with urgency tiers and savings tips
No parameter schema in public metadata yet.
get_fee_estimatesFee estimates across all confirmation targets
Fee estimates across all confirmation targets
No parameter schema in public metadata yet.
estimate_smart_feeFee estimate for a specific confirmation target
Fee estimate for a specific confirmation target
No parameter schema in public metadata yet.
compare_fee_estimatesSide-by-side comparison of fee sources
Side-by-side comparison of fee sources
No parameter schema in public metadata yet.
estimate_transaction_costExact cost estimate for a transaction before sending
Exact cost estimate for a transaction before sending
No parameter schema in public metadata yet.
analyze_blockDeep analysis of any block by height or hash
Deep analysis of any block by height or hash
No parameter schema in public metadata yet.
get_block_statsStatistical breakdown of a block
Statistical breakdown of a block
No parameter schema in public metadata yet.
get_block_countCurrent chain height
Current chain height
No parameter schema in public metadata yet.
compare_blocksCompare two blocks side by side
Compare two blocks side by side
No parameter schema in public metadata yet.
search_blocksSearch a range of blocks
Search a range of blocks
No parameter schema in public metadata yet.
analyze_transactionFull transaction analysis with inscription detection
Full transaction analysis with inscription detection
No parameter schema in public metadata yet.
decode_raw_transactionDecode a raw transaction hex
Decode a raw transaction hex
No parameter schema in public metadata yet.
send_raw_transactionBroadcast a signed transaction
Broadcast a signed transaction
No parameter schema in public metadata yet.
check_utxoCheck if a UTXO is spent or unspent
Check if a UTXO is spent or unspent
No parameter schema in public metadata yet.
analyze_mempoolFull mempool analysis — depth, fees, congestion
Full mempool analysis — depth, fees, congestion
No parameter schema in public metadata yet.
get_mempool_infoMempool size, bytes, fee floor
Mempool size, bytes, fee floor
No parameter schema in public metadata yet.
get_mempool_entryDetails for a specific unconfirmed transaction
Details for a specific unconfirmed transaction
No parameter schema in public metadata yet.
get_mempool_ancestorsAncestor chain for a mempool transaction
Ancestor chain for a mempool transaction
No parameter schema in public metadata yet.
get_mining_infoCurrent mining difficulty, hashrate, block reward
Current mining difficulty, hashrate, block reward
No parameter schema in public metadata yet.
analyze_next_blockPreview of the next block template
Preview of the next block template
No parameter schema in public metadata yet.
get_mining_pool_rankingsTop mining pools by recent blocks
Top mining pools by recent blocks
No parameter schema in public metadata yet.
get_difficulty_adjustmentTime and percentage of next difficulty change
Time and percentage of next difficulty change
No parameter schema in public metadata yet.
get_halving_countdownBlocks and estimated time until next halving
Blocks and estimated time until next halving
No parameter schema in public metadata yet.
get_blockchain_infoChain state, verification progress, softfork status
Chain state, verification progress, softfork status
No parameter schema in public metadata yet.
get_network_infoNode version, connections, relay info
Node version, connections, relay info
No parameter schema in public metadata yet.
get_node_statusConnection status and node health
Connection status and node health
No parameter schema in public metadata yet.
get_peer_infoConnected peer details
Connected peer details
No parameter schema in public metadata yet.
get_chain_tipsActive and stale chain tips
Active and stale chain tips
No parameter schema in public metadata yet.
get_chain_tx_statsTransaction throughput over N blocks
Transaction throughput over N blocks
No parameter schema in public metadata yet.
get_utxo_set_infoUTXO set size and total supply
UTXO set size and total supply
No parameter schema in public metadata yet.
get_supply_infoCirculating supply, inflation rate, percent mined
Circulating supply, inflation rate, percent mined
No parameter schema in public metadata yet.
get_situation_summaryAggregated overview — price, fees, mempool, mining
Aggregated overview — price, fees, mempool, mining
No parameter schema in public metadata yet.
get_btc_priceCurrent BTC/USD price
Current BTC/USD price
No parameter schema in public metadata yet.
get_market_sentimentFear/greed index and market indicators
Fear/greed index and market indicators
No parameter schema in public metadata yet.
get_address_utxosUTXOs for an address
UTXOs for an address
No parameter schema in public metadata yet.
validate_addressValidate and classify a Bitcoin address
Validate and classify a Bitcoin address
No parameter schema in public metadata yet.
get_address_balanceTotal received/sent/balance, tx count, first/last seen
Total received/sent/balance, tx count, first/last seen
No parameter schema in public metadata yet.
get_address_historyPaginated transaction history with net value change
Paginated transaction history with net value change
No parameter schema in public metadata yet.
get_address_transactionsTransaction history with per-transaction value details
Transaction history with per-transaction value details
No parameter schema in public metadata yet.
get_indexed_transactionEnriched tx with resolved input addresses + spent status
Enriched tx with resolved input addresses + spent status
No parameter schema in public metadata yet.
get_indexer_statusSync progress, ETA, blocks/sec
Sync progress, ETA, blocks/sec
No parameter schema in public metadata yet.
analyze_psbt_securitySecurity analysis of a Partially Signed Bitcoin Transaction
Security analysis of a Partially Signed Bitcoin Transaction
No parameter schema in public metadata yet.
explain_inscription_listing_securitySecurity guide for ordinal inscription listings
Security guide for ordinal inscription listings
No parameter schema in public metadata yet.
search_blockchainUniversal search — address, txid, block hash, or height
Universal search — address, txid, block hash, or height
No parameter schema in public metadata yet.
generate_keypairGenerate a new Bitcoin keypair
Generate a new Bitcoin keypair
No parameter schema in public metadata yet.
explain_scriptDecode and explain a Bitcoin script
Decode and explain a Bitcoin script
No parameter schema in public metadata yet.
decode_bolt11_invoiceDecode a Lightning Network BOLT11 invoice
Decode a Lightning Network BOLT11 invoice
No parameter schema in public metadata yet.
describe_rpc_commandHelp text for any Bitcoin Core RPC command
Help text for any Bitcoin Core RPC command
No parameter schema in public metadata yet.
list_rpc_commandsList all available RPC commands
List all available RPC commands
No parameter schema in public metadata yet.
decode_xpubDecode and inspect an extended public key
Decode and inspect an extended public key
No parameter schema in public metadata yet.
query_remote_apiQueries canonical /api/v1 routes on an explicitly configured endpoint
Queries canonical /api/v1 routes on an explicitly configured endpoint
No parameter schema in public metadata yet.
Sponsors
Configuration
BITCOIN_RPC_HOSTBitcoin Core RPC host (default: 127.0.0.1)
BITCOIN_RPC_PORTBitcoin Core RPC port (default: auto-selected by network)
BITCOIN_NETWORKBitcoin network: mainnet, testnet, signet, or regtest (default: mainnet). Sets default RPC port if BITCOIN_RPC_PORT is not set.
SATOSHI_API_URLOverride the default hosted API URL (default: https://bitcoinsapi.com). The hosted API is used automatically when no local node is detected.
SATOSHI_API_KEYsecretAPI key for authenticated access to the hosted Satoshi API (get one free at POST /api/v1/register)
Readme
bitcoin-mcp
Give any AI agent Bitcoin superpowers — fee intelligence, mempool analysis, and 50 tools backed by your Bitcoin node or compatible API.
50 standard tools · 6 prompts · 8 resources · Bitcoin Core or compatible API backend · MIT licensed
If bitcoin-mcp is useful to you, consider giving it a star — it helps others discover the project.
Details
- Repository
- github.com/bortlesboat/bitcoin-mcp
- Category
- Finance & Commerce
- Package
bitcoin-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active