bortlesboat avatar

Bitcoin MCP

bortlesboat/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 tools

Public 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_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_KEYsecret

API 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.

PyPI Downloads Tests License: MIT Python 3.10+ GitHub Sponsors

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.


View the full README on GitHub

Details

Repository
github.com/bortlesboat/bitcoin-mcp
Category
Finance & Commerce
Package
bitcoin-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Finance & Commerce MCP servers

View all
1hypd-ai avatarOpenai Ads Mcphypd-ai/openai-ads-mcpRead-only MCP server for the OpenAI Ads API: campaigns, ad groups, ads, and insights.2stars
2expertvagabond avatarSolanaexpertvagabond/solana-mcp-serverSolana MCP server for wallet, transactions & programs2stars
3mharnett avatarBing Adsmharnett/mcp-bing-adsMCP server for Microsoft Advertising (Bing Ads) — campaigns, keywords, and reports2stars
4rambov1 avatarSivut SEC Crypto Filing Radarrambov1/sivut-x402-public-dataSEC EDGAR crypto filing radar MCP with x402-paid Base USDC data URLs.0stars
5den-indance avatarShopify Mcp Proden-indance/shopify-mcp-proShopify MCP server with real analytics (ShopifyQL), auto-refresh auth, and Shopify API 2026-04.1stars
6mharnett avatarReddit Adsmharnett/mcp-reddit-adsReddit Ads MCP: campaigns, ad groups, ads, reporting, and audience targeting.1stars