Bitcoin MCP Server

Name: Bitcoin MCP Server
Author: moncho

@moncho

Repository

About Bitcoin MCP Server

A Bitcoin MCP Server

Basic information

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.