What is Bitcoin Mcp

bitcoin-mcp is a streamlined Model Context Protocol (MCP) server that provides access to local Bitcoin full node data. It interfaces with Bitcoin Core through ‘bitcoin-cli’ and offers read access to Bitcoin blockchain data without wallet functionality.

Use cases

Use cases for bitcoin-mcp include developing AI agents that analyze Bitcoin transactions, visualizing blockchain data for educational purposes, and integrating Bitcoin data into other applications without wallet functionalities.

How to use

To use bitcoin-mcp, clone the repository to your Bitcoin full node machine, install the required dependencies, configure the environment variables, and set up Claude Desktop or other MCP clients to connect to the server.

Key features

Key features of bitcoin-mcp include real-time querying of Bitcoin blockchain information, access to mempool, blocks, and transaction data, and the ability to generate custom 3D visualizations of BTC blocks based on transaction output values.

Where to use

bitcoin-mcp can be used in various fields such as blockchain analysis, cryptocurrency research, and AI applications that require accurate Bitcoin blockchain data.

bitcoin-mcp

bitcoin-mcp extends AI utilities with accurate Bitcoin blockchain data based on MCP. bitcoin-mcp is a streamlined Model Context Protocol (MCP) server implementation that interfaces with Bitcoin Core (full-node) through bitcoin-cli. This bitcoin-mcp server provides Claude Desktop (or other mcp clients) with READ access to Bitcoin blockchain data WITHOUT wallet functionality.

Features

AI agent meets the most secure data ledger - Bitcoin.

• Query real-time Bitcoin blockchain information (via bitcoin-cli, but WITHOUT any wallet calls)

• Access mempool, blocks, and transaction data

• Generate custom 3D visualization of BTC blocks based on TX output values and BitFeed representation (i.e., those beautiful rectangles on mempool.space)

  

Prerequisites

• Claude Desktop (or other mcp clients)
• Python 3.10+
• Bitcoin full-node (w. bitcoin-cli)
• (Windows)

Installation

1. Clone the repo to your up-to-date btc full node machine (required for bitcoin-mcp to work)

2. Install dependencies:

pip install -r requirements.txt

3. Make sure Bitcoin Core is up-to-date and running. Configure .env and add BITCOIN_CLI_PATH so that MCP server can find bitcoin-cli

• Have this line BITCOIN_CLI_PATH=C:\\Program Files\\Bitcoin\\daemon\\bitcoin-cli in .env

4. Claude Desktop Configuration (standard setup for any mcp servers)

• update path\\to\\ to your local bitcoin-mcp folder

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "python",
      "args": ["path\\to\\bitcoin-mcp\\bitcoin_mcp_server.py"],
      "env": {}
    }
  }
}

Test the server:

You can test the python server to see if it loads your btc full node.

python bitcoin_mcp_server.py

Available Tools

Mainly for mcp clients like Claude Desktop to utilize Bitcoin blockchain info, so NO WALLET FUNCTIONS ARE INCLUDED.

Blockchain Information

Transaction Information

Analytics

Configuration

Code Structure

• bitcoin_mcp_server.py: Main server entry point
• bitcoin_connection.py: Bitcoin Core connection utilities
• bitcoin_config.py: Configuration management
• bitcoin_transactions.py: Transaction analysis utilities
• bitcoin_utils.py: Blockchain utilities
• bitcoin_analytics.py: Advanced blockchain analytics
• bitfeed.py: 3D representations of BTC blocks

Security Notes

• This mcp server does not include wallet functionality in Bitcoin Core (u can add those urself)
• By default, the server only binds to localhost (127.0.0.1)
• Enables read-only access to blockchain data

Example Usage

Get current blockchain information:

Tell me about the current state of the Bitcoin blockchain

Analyze a specific block:

Show me detailed information about block 800000

Get transaction fee history:

What have transaction fees been like over the past 24 hours?

Estimate hashrate:

What is the current estimated hashrate of the Bitcoin network?

Generate 3D representation (note that context length may not fit all TXs, try blocks where TX number < 20 ):

Build a react threejs viewer for btc block 111111

License

MIT License