MCP.Market

Bitcoin MCP server

by Bortlesboat·io.github.Bortlesboat/bitcoin-mcp·v0.5.1·5 stars
No reviews yet

49 Bitcoin tools for AI agents: fees, mempool, blocks, mining, price. Zero config.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

5 stars61 downloads/wk

Reviews

Write one

Nobody has reviewed Bitcoin MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Bitcoin MCP tools (49, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • analyze_block

    Analyze a block: mining pool, SegWit/Taproot adoption, fee distribution, revenue.

  • analyze_mempool

    Analyze the mempool: tx count, fee buckets, congestion level, next-block minimum fee.

  • analyze_next_block

    Predict next block: transactions, weight utilization, miner revenue, fee percentiles, top-fee txs.

  • analyze_psbt_security

    Analyze a PSBT for ordinals inscription listing mempool sniping vulnerability.

  • analyze_transaction

    Decode and analyze a transaction: inputs, outputs, fee rate, SegWit/Taproot flags, inscription detection.

  • check_utxo

    Check if a specific transaction output is unspent (UTXO lookup).

  • compare_blocks

    Compare block statistics between two block heights side by side.

  • compare_fee_estimates

    Compare fee estimates side-by-side with urgency labels and cost for a typical 140 vB transaction.

  • decode_bolt11_invoice

    Decode a BOLT11 Lightning invoice without external dependencies.

  • decode_raw_transaction

    Decode a raw transaction hex without looking up inputs.

  • describe_rpc_command

    Get structured help for a Bitcoin RPC command: description, arguments, examples.

  • estimate_smart_fee

    Get fee estimate for a specific confirmation target.

  • estimate_transaction_cost

    Estimate Bitcoin transaction cost in sats AND USD at different urgency levels. Supports address types: p2pkh (legacy), p2sh-p2wpkh (nested segwit), p2wpkh (native segwit), p2tr (taproot). Shows how much you save by waiting.

  • explain_inscription_listing_security

    Explain in plain language whether an ordinals inscription listing is snipe-resistant.

  • explain_script

    Decode a Bitcoin Script hex and break down the opcodes.

  • generate_keypair

    Generate a new Bitcoin address via the connected node's wallet. Requires a local node with a wallet loaded — not available when using the hosted Satoshi API.

  • get_address_balance

    Get the total balance, transaction count, and first/last seen times for a Bitcoin address.

  • get_address_history

    Get paginated transaction history for a Bitcoin address.

  • get_address_utxos

    Scan the UTXO set for all unspent outputs belonging to an address. Note: scans full UTXO set, may take minutes.

  • get_block_count

    Get current block height (lightweight, fast).

  • get_block_stats

    Get raw block statistics: median fee, total output, subsidy, weight, tx count.

  • get_blockchain_info

    Get blockchain info: chain, difficulty, softfork statuses, chain work, pruning.

  • get_btc_price

    Get current BTC/USD price from CoinGecko (free, no API key). Returns price, 24h change, and market cap. Use this to convert sat/vB fees into dollar amounts.

  • get_chain_tips

    Get chain tips: active chain, forks, and stale branches. Useful for detecting chain splits.

  • get_chain_tx_stats

    Get transaction rate statistics over N blocks.

  • get_difficulty_adjustment

    Calculate difficulty adjustment progress: blocks into epoch, blocks remaining, estimated time, and projected adjustment.

  • get_fee_estimates

    Get fee rate estimates for 1/3/6/25/144 block confirmation targets in sat/vB.

  • get_fee_recommendation

    Get a plain-English fee recommendation based on current estimates, with raw rate data.

  • get_halving_countdown

    Get a focused countdown to the next Bitcoin halving: blocks remaining, estimated date, and subsidy change.

  • get_indexed_transaction

    Get enriched transaction details from the blockchain indexer.

  • get_indexer_status

    Check the blockchain indexer sync progress.

  • get_market_sentiment

    Get Bitcoin Fear & Greed Index: current value (0-100), classification (Extreme Fear/Fear/Neutral/Greed/Extreme Greed), and 7-day history. Use this to gauge market sentiment alongside price data.

  • get_mempool_ancestors

    Get all unconfirmed ancestor transactions of a mempool transaction. Useful for CPFP analysis.

  • get_mempool_entry

    Get details of a specific unconfirmed transaction in the mempool.

  • get_mempool_info

    Get quick mempool stats: transaction count, size in bytes, min relay fee.

  • get_mining_info

    Get mining info: difficulty, network hashrate, current block size.

  • get_mining_pool_rankings

    Get top 10 Bitcoin mining pools by hashrate share over the last week. Returns pool name, percentage of total hashrate, and block count. Use this to understand mining centralization and pool dominance.

  • get_network_info

    Get network info: protocol version, relay fee, connections, warnings. In hosted API mode, reflects the API server's network view.

  • get_node_status

    Get Bitcoin network status: chain, height, sync progress, disk usage, connections, version. In hosted API mode, reflects the API server's node.

  • get_peer_info

    Get connected peer details: addresses, latency, services, version. In hosted API mode, shows the API server's peers.

  • get_situation_summary

    Get a quick Bitcoin briefing: price, fees, mempool, and chain tip in one call. Use this as your first call to understand current conditions — replaces calling 5+ tools separately.

  • get_supply_info

    Get Bitcoin supply data: circulating supply, max supply, inflation rate, subsidy per block, and next halving estimate.

  • get_utxo_set_info

    Get UTXO set statistics: total UTXOs, total supply, disk size. Note: this is a slow operation (1-2 minutes on local nodes, may vary on hosted API).

  • list_rpc_commands

    List all available RPC commands grouped by category.

  • query_remote_api

    Query a remote Satoshi API instance, auto-paying with Lightning if needed.

  • search_blockchain

    Smart search: auto-detects if query is a txid, block hash, block height, or address and returns the right data.

  • search_blocks

    Get block statistics for a range of heights. Max 10 blocks.

  • send_raw_transactionwrite action

    Broadcast a signed raw transaction to the Bitcoin network.

  • validate_address

    Validate a Bitcoin address and return its type (legacy/segwit/taproot), network, and script info. Use this to check if an address is valid before sending, or to identify what kind of address you're looking at.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 18 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Bitcoin MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
49
the typical server has 7
Tools that change things
2%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
5
more than 83% of 28,688 servers
Downloads a week
61
more than 49% of 12,191 servers with a package

What its tools let an agent do: 47 read · 1 create · 1 send or post

Install Bitcoin MCP in Claude Code, Cursor or VS Code

claude mcp add bitcoin-mcp -- uvx bitcoin-mcp
Add to Cursor

What the publisher says

From the Bitcoin MCP repository's README, as published. We do not edit it. Read it on GitHub

bitcoin-mcp

<!-- mcp-name: io.github.Bortlesboat/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.

pip install "bitcoin-mcp>=0.5.2"

bitcoin-mcp needs a Bitcoin data backend. It auto-detects a local Bitcoin Core/Knots node from its cookie or RPC settings. Without a local node, set SATOSHIAPIURL to a compatible deployment.

Service status: the public Satoshi API previously hosted at bitcoinsapi.com is paused and should not be treated as a working default. Use a local node or an explicitly configured compatible API.

Install status

Version 0.5.2 includes the MCP SDK 1.x compatibility constraint and explicit backend selection. Upgrade older installations to receive these fixes.

Quick Start

Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

Claude Code

claude mcp add bitcoin -- uvx --from "bitcoin-mcp>=0.5.2" bitcoin-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

Zed

Add to your Zed settings.json under context_servers:

{
  "context_servers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["--from", "bitcoin-mcp>=0.5.2", "bitcoin-mcp"]
    }
  }
}

See the Zed MCP docs for the current settings location and custom server flow.

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

Ask whether to send Bitcoin now

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

Expected path:

  1. The agent calls getfeerecommendation.
  2. The answer gives a clear send now or wait recommendation with fee rates in sat/vB.
  3. If the backend is unavailable, configure a local node or set SATOSHIAPIURL before 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.

Agent Integration

For repos that need Bitcoin tools, add bitcoin-mcp to the agent's MCP config and configure one of its supported backends:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Bitcoin MCP: common questions

Is Bitcoin MCP server safe?
Mostly: it is graded B (83/100). Read the Bitcoin MCP safety report
How do I install Bitcoin MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Bitcoin MCP need an API key?
Yes. The registry entry asks for SATOSHI_API_KEY.
Is Bitcoin MCP maintained?
The last commit was 55 days ago (2026-09-10). The latest release is v0.5.1.
How does Bitcoin MCP compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 49 (the typical server has 7); tools that change things 2% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.