First Bitcoin MCP Server on the Anthropic Registry
Give your AI agents real-time Bitcoin data. Free. No signup.
The Bitcoin API built for the agent era. MCP-native tooling, fee intelligence that saves money on every transaction, and real-time mempool data — so your agents make smart Bitcoin decisions without human babysitting.
$ pip install bitcoin-mcpLoading live fee data...Try These Prompts
Copy any prompt below into Claude Desktop with bitcoin-mcp installed. Each one works out of the box.
"Should I send Bitcoin right now?"
Get a send/wait recommendation with specific sat/vB rates and estimated savings if you wait.
"Track this payment"
Paste a txid. Get confirmation count, fee rate, RBF status, and whether it'll make the next block.
"What's happening in the mempool?"
Congestion level, fee buckets, next-block minimum fee, and total pending transactions.
"Compare urgency levels"
Side-by-side: next block vs. 3 blocks vs. 6 blocks vs. 1 day. Exact sats at each level.
"Decode this transaction"
Full breakdown: inputs, outputs, fee rate, SegWit/Taproot flags, script types. Plain English.
"What will the next block look like?"
Projected next block: tx count, total fees, fee percentiles, and top-paying transactions.
Why Satoshi API
If it doesn't, we don't build it.
First Bitcoin API on the Anthropic MCP Registry. Your AI agents check fees, verify payments, and monitor addresses — no human babysitting a block explorer.
"Fees are low. Good time to send." Combines multiple fee targets with mempool state so you never overpay. Every transaction where you wait instead of overpaying = sats saved.
$0/month vs $49-100/mo for competitors. Your node, your data, your API. Apache-2.0 licensed. Or use our hosted version free.
The Stack
Bitcoin Core's JSON-RPC was built for humans at a terminal. Satoshi API wraps it in a clean REST layer that AI agents and applications can consume directly — with MCP tooling, fee intelligence, typed responses, and smart caching.
Instead of calling estimatesmartfee five times and doing math, your agent gets a single endpoint with human-readable recommendations in sat/vB.
What You Get
MCP tooling, fee intelligence, and production infrastructure.
First Bitcoin API on the Anthropic MCP Registry. Pair with bitcoin-mcp to give Claude or GPT direct access to your node via MCP tool calls. Your agents check fees, verify payments, and broadcast transactions.
"Send now or wait?" Not just a fee rate — actual recommendations with mempool context. Congestion scores. Block weight analysis. All in sat/vB.
Your node, your data, your API. No third party sees your queries. No vendor lock-in. No surprise pricing changes. Apache-2.0 licensed.
Every response: { data, meta }. Every error: { error }. Request IDs on everything. Consistent and predictable — ideal for agent parsing.
Optional L402 support via the bitcoin-api-l402 extension package. Pay-per-request via Lightning for Bitcoin-native API access.
Reorg-aware caching, tiered rate limiting, input validation, API key auth, 421+ tests, Docker support, and Cloudflare Tunnel deployment. Battle-tested so you don't have to be.
See It Work
Ask "should I send now?" and get a real answer, not a raw number.
Request
GET /api/v1/blocks/latestResponse
{
"data": {
"hash": "00000000000...",
"height": 885421,
"tx_count": 3847,
"size": 1648231
},
"meta": {
"cached": false,
"node": "local"
}
}Built For
Anyone who needs programmatic Bitcoin data that saves money or time.
Give your AI agents real-time Bitcoin data via MCP. Fee checks, payment verification, address monitoring — all through tool calls, no custom integration code.
# claude desktop config
"bitcoin": {
"command": "bitcoin-mcp",
"env": {"SATOSHI_API_URL":
"http://localhost:9332"}
}Building a wallet, payment processor, or Bitcoin app? Fee estimates, broadcast transactions, look up UTXOs. All validated and typed.
curl -X POST localhost:9332/api/v1/broadcast \
-H "X-API-Key: sk_..." \
-d '{"hex": "0200000001..."}'You run a node already. Check fees, monitor the mempool, build a dashboard. Point at your node, done.
curl localhost:9332/api/v1/mempool
# Congestion level, fee buckets,
# next-block minimum feePull block stats, mining data, and fee trends into your analytics pipeline. JSON responses, consistent format.
curl localhost:9332/api/v1/mining
# Difficulty, hashrate, next
# retarget height, blocks untilThird-party APIs correlate your address lookups with your IP. Self-hosted means zero data leakage. Query your own node, keep your privacy.
Teaching Bitcoin internals? The interactive docs at /docs let students explore blocks, transactions, and the mempool with live data.
API Surface
Fees, mempool, blocks, transactions, mining, network, prices, and real-time streams.
| Method | Endpoint | Description |
|---|---|---|
| GET | /health | Node reachability check |
| GET | /status | Full node status (sync, peers, disk) |
| GET | /blocks/latest | Latest block analysis |
| GET | /blocks/tip/height | Current chain height |
| GET | /blocks/tip/hash | Current tip block hash |
| GET | /blocks/{height_or_hash} | Block by height or hash |
| GET | /blocks/{height}/stats | Detailed block statistics |
| GET | /blocks/{hash}/txids | Transaction IDs in a block |
| GET | /blocks/{hash}/txs | Full transactions in a block |
| GET | /blocks/{hash}/header | Raw block header |
| GET | /tx/{txid} | Transaction analysis (fees, SegWit, Taproot) |
| GET | /tx/{txid}/raw | Raw decoded transaction |
| GET | /tx/{txid}/hex | Transaction as hex string |
| GET | /tx/{txid}/status | Confirmation status |
| GET | /tx/{txid}/outspends | Spending status of each output |
| GET | /utxo/{txid}/{vout} | UTXO lookup (spent/unspent) |
| POST | /decode | Decode raw transaction hex |
| POST | /broadcast | Broadcast signed transaction |
| GET | /fees | Fee estimates (all targets) |
| GET | /fees/recommended | Human-readable fee recommendation |
| GET | /fees/{target} | Fee for specific confirmation target |
| GET | /fees/landscape | Should I send now or wait? Decision engine |
| GET | /fees/estimate-tx | Transaction size and fee cost estimator |
| GET | /fees/history | Historical fee rates and cheapest hour |
| GET | /fees/mempool-blocks | Fee distribution by projected blocks |
| GET | /mempool | Mempool analysis (congestion, fee buckets) |
| GET | /mempool/info | Raw mempool info |
| GET | /mempool/tx/{txid} | Single mempool entry |
| GET | /mempool/txids | All mempool transaction IDs |
| GET | /mempool/recent | Recently added mempool entries |
| GET | /mining | Mining stats (difficulty, hashrate, retarget) |
| GET | /mining/nextblock | Next block template analysis |
| GET | /network | Network info (connections, relay fee) |
| GET | /network/forks | Chain tips and fork detection |
| GET | /network/difficulty | Current difficulty and retarget info |
| GET | /network/validate-address/{addr} | Validate a Bitcoin address |
| GET | /prices | BTC price in 6 fiat currencies Extended |
| GET | /stream/blocks | Real-time new block events (SSE) |
| GET | /stream/fees | Live fee rate updates every 30s (SSE) |
| GET | /address/{address} | Address balance and UTXO summary Extended |
| GET | /address/{address}/utxos | List unspent outputs for an address Extended |
| POST | /register | Self-serve API key registration |
| GET | /tools/exchange-compare | Compare exchange prices and fees Extended |
All endpoints prefixed with /api/v1. Interactive docs at /docs (Swagger UI) and /redoc.
Get Started
No node, no install, no signup. Just start making requests:
# Get current fee recommendations
curl https://bitcoinsapi.com/api/v1/fees/recommended
# Latest block analysis
curl https://bitcoinsapi.com/api/v1/blocks/latest
# Mempool congestion
curl https://bitcoinsapi.com/api/v1/mempool
# Mining stats
curl https://bitcoinsapi.com/api/v1/miningNo API key needed for GET requests. Try the interactive API playground.
Unlock 10,000 requests/day and POST access. Takes 5 seconds:
Already running Bitcoin Core? Run the full API locally: pip install satoshi-api && satoshi-api. Unlimited requests, full privacy. Self-hosting guide →
Use the Python SDK for typed access to all endpoints:
pip install satoshi-api-sdkPricing
Start free. No node required. Upgrade when you need more.
Enterprise — Need higher limits? Contact api@bitcoinsapi.com for enterprise pricing.
Comparison
| Feature | Satoshi API | Raw RPC | Hosted APIs |
|---|---|---|---|
| AI agent support (MCP) | On Anthropic Registry | No | No |
| Fee intelligence | Send now or wait? Congestion scoring | Raw values only | Varies |
| Setup time | 3 lines | Already there | Sign up + API key |
| Self-hosted | Yes | Yes | No |
| Privacy | Your node, your data | Your node | They see your queries |
| Caching | Reorg-aware TTL | None | Varies |
| Rate limiting | Built-in, tiered | None | Yes (their limits) |
| Input validation | Before RPC call | None | Yes |
| Cost to start | $0 (hosted or self-host) | $0 | $50-500+/mo |
| Vendor lock-in | None (Apache-2.0) | None | Yes |
The Road Ahead
MCP server on the Anthropic Registry. Agents check fees, verify payments, and broadcast transactions.
Know when to send. Stop overpaying. Real-time fee streams and congestion scoring.
"Notify me when fees drop below 5 sat/vB." "Tell me when this payment confirms."
For recurring buys, find the cheapest fee windows automatically.
No signup, no install, no node. MCP-ready or plain REST.