₿ Bitcoin MCP Server

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": {