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.

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

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

• 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

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

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

Click the install link above or use:

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

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

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.

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

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

Retrieve recent transactions for an address:

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

View complete information about a specific transaction:

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

Retrieve block details by height:

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

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

• 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

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

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

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

MIT License – see LICENSE.md for details.

If you find this project useful, consider supporting it:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f