# Bitcoin MCP

Bitcoin MCP is an MCP server for Claude Code that gives an agent tools to inspect Bitcoin fees, the mempool, blocks, and transactions. It connects to a local Bitcoin Core/Knots node or a compatible API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: Bortlesboat
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Bortlesboat/bitcoin-mcp
- Updated: 2026-11-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bitcoin-mcp

## What it does

Bitcoin MCP gives an agent tools for fee estimates and Bitcoin network data. It can compare transaction costs across confirmation targets, inspect mempool congestion, look up transactions, and retrieve block or mining details.

The server needs a data source: a local Bitcoin Core/Knots node with RPC settings, or a compatible API configured through `SATOSHI_API_URL`; the API may also require `SATOSHI_API_KEY`. Local node connections use `BITCOIN_RPC_HOST` and `BITCOIN_RPC_PORT`, with optional credentials or a data directory. The public Satoshi API at `bitcoinsapi.com` is paused and should not be used as a working default.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `BITCOIN_RPC_HOST`, `BITCOIN_RPC_PORT`, `BITCOIN_NETWORK`, `SATOSHI_API_URL`, `SATOSHI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> --env BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> --env BITCOIN_NETWORK=<BITCOIN_NETWORK> --env SATOSHI_API_URL=<SATOSHI_API_URL> --env SATOSHI_API_KEY=<SATOSHI_API_KEY> --transport stdio bitcoin-mcp -- uvx bitcoin-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add bitcoin-mcp --env BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> --env BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> --env BITCOIN_NETWORK=<BITCOIN_NETWORK> --env SATOSHI_API_URL=<SATOSHI_API_URL> --env SATOSHI_API_KEY=<SATOSHI_API_KEY> -- uvx bitcoin-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bitcoin-mcp": {
            "command": "uvx",
            "args": [
                "bitcoin-mcp"
            ],
            "env": {
                "BITCOIN_RPC_HOST": "<BITCOIN_RPC_HOST>",
                "BITCOIN_RPC_PORT": "<BITCOIN_RPC_PORT>",
                "BITCOIN_NETWORK": "<BITCOIN_NETWORK>",
                "SATOSHI_API_URL": "<SATOSHI_API_URL>",
                "SATOSHI_API_KEY": "<SATOSHI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bitcoin-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "bitcoin-mcp"
            ],
            "env": {
                "BITCOIN_RPC_HOST": "<BITCOIN_RPC_HOST>",
                "BITCOIN_RPC_PORT": "<BITCOIN_RPC_PORT>",
                "BITCOIN_NETWORK": "<BITCOIN_NETWORK>",
                "SATOSHI_API_URL": "<SATOSHI_API_URL>",
                "SATOSHI_API_KEY": "<SATOSHI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BITCOIN_RPC_HOST=<BITCOIN_RPC_HOST> -e BITCOIN_RPC_PORT=<BITCOIN_RPC_PORT> -e BITCOIN_NETWORK=<BITCOIN_NETWORK> -e SATOSHI_API_URL=<SATOSHI_API_URL> -e SATOSHI_API_KEY=<SATOSHI_API_KEY> bitcoin-mcp uvx bitcoin-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from bitcoin-mcp <command>

## When to use it
- estimate a Bitcoin transaction fee before sending
- compare costs for different confirmation targets
- inspect mempool congestion and fee levels
- look up and analyze a transaction
- retrieve a snapshot of Bitcoin fees, blocks, and mining

## Example prompts
- Estimate the fee for sending Bitcoin now and compare it with waiting for confirmation.
- Inspect current mempool congestion and report the fee levels.
- Look up and analyze this transaction: `abc123...`

## Similar
- [satoshidata — Bitcoin entity intelligence](https://affpapa.org/en/nevibecode/mcp/satoshidata-bitcoin-entity-intelligence.md) — MCP server · 4144 installs
- [Bitview](https://affpapa.org/en/nevibecode/mcp/bitview.md) — MCP server · ★ 179 repo stars
- [mcp-mercado-bitcoin](https://affpapa.org/en/nevibecode/mcp/mcp-mercado-bitcoin.md) — MCP server · ★ 279 repo stars
- [Carbon & Cashmere Crypto Intelligence](https://affpapa.org/en/nevibecode/mcp/carbon-cashmere-crypto-intelligence.md) — MCP server · 1051 installs
- [US Spot Bitcoin & Ethereum ETF Flows](https://affpapa.org/en/nevibecode/mcp/us-spot-bitcoin-ethereum-etf-flows.md) — MCP server · ★ 1 repo stars
- [follow-the-crypto](https://affpapa.org/en/nevibecode/skills/follow-the-crypto.md) — skill · 1800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
