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:**
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:
Manual Installation
**Requirements:** Node.js 18+ and npm
Claude Desktop
Add to claude_desktop_config.json:
**macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows**: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after configuration.
Usage Examples
Get Address Statistics
View funded/spent amounts and transaction counts for any Bitcoin address:
Get Transaction History
Retrieve recent transactions for an address:
Get Transaction Details
View complete information about a specific transaction:
Get Block Information
Retrieve block details by height:
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