JamesANZ/bitcoin-mcp

Real-time Bitcoin blockchain data in your AI workflow. Query addresses, transactions, blocks, and UTXOs from the mempool.space API. No API keys required.

An MCP (Model Context Protocol) server that brings live Bitcoin blockchain data into AI coding environments like Cursor and Claude Desktop.

Why Use Bitcoin MCP?

• 🔒 No API Keys – Works out of the box with mempool.space
• ⚡ Real-time Data – Live blockchain data, addresses, transactions, blocks
• 🎯 Easy Setup – One-click install in Cursor or simple manual setup
• 📊 Comprehensive – Address stats, transaction history, UTXOs, block info
• 🌐 Public API – Uses reliable mempool.space infrastructure

Quick Start

Ready to explore Bitcoin blockchain data? Install in seconds:

Install in Cursor (Recommended):

🔗 Install in Cursor

Or install manually:

npm install -g @jamesanz/bitcoin-mcp
# Or from source:
git clone https://github.com/JamesANZ/bitcoin-mcp.git
cd bitcoin-mcp && npm install && npm run build

Features

🔍 Address Tools

• get-address-stats – Get funded/spent amounts, transaction counts
• get-address-transactions – Transaction history with status, dates, fees
• get-address-utxos – Current unspent outputs with amounts and confirmations

🔗 Transaction Tools

• get-transaction – Complete transaction details (inputs, outputs, fees, confirmations)

🧱 Block Tools

• get-block – Block information (hash, timestamp, size, transaction count, fees)

Installation

Cursor (One-Click)

Click the install link above or use:

cursor://anysphere.cursor-deeplink/mcp/install?name=bitcoin-mcp&config=eyJiaXRjb2luLW1jcCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqYW1lc2Fuei9iaXRjb2luLW1jcCJdfX0=

Manual Installation

Requirements: Node.js 18+ and npm

# Clone and build
git clone https://github.com/JamesANZ/bitcoin-mcp.git
cd bitcoin-mcp
npm install
npm run build

# Run server
npm start

Claude Desktop

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["@jamesanz/bitcoin-mcp"]
    }
  }
}

Restart Claude Desktop after configuration.

Usage Examples

Get Address Statistics

View funded/spent amounts and transaction counts for any Bitcoin address:

{
  "tool": "get-address-stats",
  "arguments": {
    "address": "1wiz18xYmhRX6xStj2b9t1rwWX4GKUgpv"
  }
}

Get Transaction History

Retrieve recent transactions for an address:

{
  "tool": "get-address-transactions",
  "arguments": {
    "address": "1wiz18xYmhRX6xStj2b9t1rwWX4GKUgpv",
    "limit": 5
  }
}

Get Transaction Details

View complete information about a specific transaction:

{
  "tool": "get-transaction",
  "arguments": {
    "txid": "15e10745f15593a899cef391191bdd3d7c12412cc4696b7bcb669d0feadc8521"
  }
}

Get Block Information

Retrieve block details by height:

{
  "tool": "get-block",
  "arguments": {
    "block_height": 857808
  }
}

Data Source

Source	Coverage	Update Frequency
mempool.space	Bitcoin mainnet blockchain	Real-time

All amounts are displayed in BTC (converted from satoshis). Timestamps are in ISO format.

Use Cases

• Blockchain Analytics – Track addresses, transactions, and blocks
• Bitcoin Developers – Build apps with real blockchain data
• Researchers – Analyze transaction patterns and network activity
• Traders – Monitor addresses and transaction flows

Technical Details

Built with: Node.js, TypeScript, MCP SDK
Dependencies: @modelcontextprotocol/sdk, superagent, zod
Platforms: macOS, Windows, Linux

API Endpoints:

• GET /api/address/{address} – Address statistics
• GET /api/address/{address}/txs – Transaction history
• GET /api/address/{address}/utxo – UTXOs
• GET /api/tx/{txid} – Transaction details
• GET /api/block/{height} – Block information

Contributing

⭐ If this project helps you, please star it on GitHub! ⭐

Contributions welcome! Please open an issue or submit a pull request.

License

MIT License – see LICENSE.md for details.

Support

If you find this project useful, consider supporting it:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f