Bitcoin MCP Server

What is Bitcoin MCP Server?

A Go-based service that provides a unified interface to interact with a Bitcoin node through various RPC commands using the Model Context Protocol (MCP). It organizes Bitcoin RPC functionality into logical categories and is intended for developers who need to access blockchain data and operations programmatically.

How to use Bitcoin MCP Server?

Clone the repository, install dependencies with go mod download, build with go build -o bitcoin-mcp, and create a config.json with Bitcoin RPC credentials and server settings. Run ./bitcoin-mcp -config config.json after starting a Bitcoin Core node with RPC enabled. Then call RESTful endpoints like POST /api/v1/blockchain/info.

Key features of Bitcoin MCP Server

• Unified Bitcoin RPC interface via Model Context Protocol
• Organized into blockchain, mempool, UTXO, and management categories
• Secure authentication support
• Comprehensive error handling
• Clean, documented RESTful API
• Go-based, easy to extend with new RPC commands

Use cases of Bitcoin MCP Server

• Retrieve blockchain information and individual block data
• Monitor mempool transaction count and details
• Query UTXO set for specific outputs or addresses
• Integrate Bitcoin Core RPC into AI/LLM workflows via MCP
• Build custom blockchain analysis or management tools

FAQ from Bitcoin MCP Server

What are the prerequisites?

Go 1.24 or later and a Bitcoin Core node with RPC enabled (run with -server -rpcuser and -rpcpassword flags).

How do I configure the server?

Create a config.json with bitcoin.rpc_url, bitcoin.username, bitcoin.password, server.port, and server.host. Alternatively, set environment variables BITCOIN_RPC_URL, BITCOIN_RPC_USER, and BITCOIN_RPC_PASS.

How do I secure the server?

Never expose RPC credentials in public repositories, use strong passwords, consider rate limiting for public APIs, validate all input parameters, and sanitize error messages.

How do I add new RPC commands?

Add the method to the Bitcoin client in pkg/bitcoin/client.go, create or update the corresponding tool in pkg/tools/, register it in the appropriate category, and add tests.

What transport and authentication does the server use?

The server exposes a RESTful API (HTTP) over the configured port and host. Authentication is handled via the Bitcoin RPC credentials provided in the configuration.