Bitcoin MCP
About
49 Bitcoin tools for agents: fees, mempool, blocks, mining, price, and transactions.
Details
- Author
- bortlesboat
- Categories
- Developer Tools, Other, Finance
Jump to
Setup
Install Bitcoin MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/bortlesboat/bitcoin-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
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 astar— it helps others discover the project.
Service status:the public Satoshi API previously hosted atbitcoinsapi.comis paused and should not be treated as a working default. Use a local node or an explicitly configured compatible API.
Add to yourclaude_desktop_config.json:
{ "mcpServers": { "bitcoin": { "command": "uvx", "args": ["bitcoin-mcp"] } } }
claude mcp add bitcoin -- uvx bitcoin-mcp
{ "mcpServers": { "bitcoin": { "command": "uvx", "args": ["bitcoin-mcp"] } } }
{ "servers": { "bitcoin": { "command": "uvx", "args": ["bitcoin-mcp"] } } }
Add to your Zedsettings.jsonundercontext_servers:
{ "context_servers": { "bitcoin": { "command": "uvx", "args": ["bitcoin-mcp"] } } }
See theZed MCP docsfor the current settings location and custom server flow.
docker build -t bitcoin-mcp . docker run -i bitcoin-mcp
Pass environment variables to connect to a local Bitcoin Core node or a compatible API:
docker run -i -e BITCOIN_RPC_HOST=host.docker.internal -e BITCOIN_RPC_PORT=8332 bitcoin-mcp # or docker run -i -e SATOSHI_API_URL=https://your-api.example bitcoin-mcp
Use this as the first useful activation path after install:
"I need to send a Bitcoin transaction today. Use bitcoin-mcp to decide whether to send now or wait, and show the fee rate you used."
- The agent callsget_fee_recommendation.
- The answer gives a clear send now or wait recommendation with fee rates in sat/vB.
- If the backend is unavailable, configure a local node or setSATOSHI_API_URLbefore retrying.
After it works, Star this repo and share a short showcase with the prompt, tool call, and outcome so other Bitcoin agent builders can see the path.
For repos that need Bitcoin tools, addbitcoin-mcpto the agent's MCP config and configure one of its supported backends:
- Local Bitcoin Core/Knots RPC settings:BITCOIN_RPC_HOST,BITCOIN_RPC_PORT, and optional credentials or datadir
- Compatible remote API:SATOSHI_API_URLand, when required,SATOSHI_API_KEY
- Satoshi API source and integration reference:https://github.com/Bortlesboat/bitcoin-api/blob/main/docs/AGENT_INTEGRATION.md
Generated HTTP examples should use canonical Satoshi API/api/v1paths.
- Fee intelligence that saves real money— know the cheapest time to send, compare fee tiers, estimate exact costs before broadcasting
- Backend choice— use your own Bitcoin Core/Knots node or an explicitly configured compatible API
- First Bitcoin MCP server on theAnthropic Registry
Indexed Address (requires blockchain indexer)
query_remote_apiis registered only whenSATOSHI_API_URLis set and thel402extra is installed. It queries canonical/api/v1routes on that explicitly configured endpoint.
Configure either a local Bitcoin Core/Knots node or a compatible remote API. If neither is available, bitcoin-mcp exits its connection check with a setup error instead of silently selecting an unavailable public service.
bitcoin-mcpsupports the following runtime flags:
bitcoin-mcp --transport sse --host 127.0.0.1 --port 8000 --log-level DEBUG
To connect to a local Bitcoin Core node:
{ "mcpServers": { "bitcoin": { "command": "uvx", "args": ["bitcoin-mcp"], "env": { "BITCOIN_RPC_HOST": "127.0.0.1", "BITCOIN_RPC_PORT": "8332" } } } }
6 built-in promptsfor common workflows:analyze_fee_environment,investigate_transaction,monitor_mempool_fees,taproot_adoption_report,network_health_report,track_transaction
8 resourcesfor context injection:bitcoin://connection/status,bitcoin://node/status,bitcoin://fees/current,bitcoin://fees/history,bitcoin://mempool/snapshot,bitcoin://protocol/script-opcodes,bitcoin://protocol/address-types,bitcoin://protocol/sighash-types
- Satoshi API source— optional compatible backend implementation (public hosted service currently paused)
- Anthropic MCP Registry—io.github.Bortlesboat/bitcoin-mcp
- PyPI
- GitHub
- Full tool documentation
See theexamples/folder for documented usage patterns:
- Fee Analysis— find optimal send timing
- Mempool Monitor— track congestion
- Transaction Investigation— decode and analyze transactions
- Block Analysis— inspect and compare blocks
bitcoin-mcp is free, open-source Bitcoin infrastructure. Support development throughOpenSats.
Contributions are welcome. SeeCONTRIBUTING.mdfor guidelines, including how to add new tools and the PR checklist.
Please report security vulnerabilities privately — seeSECURITY.md.
bitcoin-mcp is created and maintained byAndrew Barnes, bridging AI agents and Bitcoin infrastructure through the Model Context Protocol.
- Satoshi API— Bitcoin fee intelligence API, 108 endpoints, usable as a self-hosted compatible backend
- ChainPulse— AI-powered Bitcoin network intelligence CLI
- BAIP-1— Bitcoin Agent Identity Protocol
- bitcoin-fee-observatory— Fee market analytics dashboard
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Access real-time and historical crypto market data from CoinAPI’s MCP server, built for developers and AI agents needing reliable, unified market coverage.
Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.
50+ pay-per-call APIs for AI agents via HTTP 402 crypto micropayments. $0.001–$0.12 per call with USDC and USDm.
Interact with Alchemy's blockchain APIs to query data without writing code.
Interact with Aptos documentation and create full-stack Aptos blockchain applications.
A MCP server for interacting with Aptos NPM packages.
The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.
Interact with the Bitcoin and Lightning Network to generate keys, validate addresses, decode transactions, and query the blockchain.
An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.
Interact with over 100 cryptocurrency exchange APIs using the CCXT library.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
