MCP Blockchain Query Server

Name: MCP Blockchain Query Server
Author: pavel-bc

@pavel-bc

Repository

About MCP Blockchain Query Server

🤖 MCP server for querying BTC data via Blockchain.com APIs

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-blockchain-query": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

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 MCP Blockchain Query Server?

MCP Blockchain Query Server is a Model Context Protocol server that provides tools for querying Bitcoin blockchain data via the Blockchain.com Data and Query APIs. It is intended for developers who need to retrieve live BTC blockchain information through a standardized MCP interface.

How to use MCP Blockchain Query Server?

Install dependencies with pip install -r requirements.txt inside a Python virtual environment, then run python main.py for stdio mode or python main.py --transport sse --port 8000 for SSE mode. Optional CLI arguments: --port (default 8000) and --transport (stdio or sse, default stdio).

Key features of MCP Blockchain Query Server

Supports both stdio and SSE transport modes
17 built-in MCP tools for BTC blockchain queries
Get block, transaction, and address details by hash
Retrieve blockchain statistics (difficulty, hash rate, average transaction size)
Access market price and network metrics (block reward, interval, next retarget)
Query unconfirmed transaction count and 24-hour transaction count

Use cases of MCP Blockchain Query Server

Retrieve the current Bitcoin block height and difficulty
Look up a specific transaction or address balance
Monitor network statistics like hash rate and average transaction size
Check the latest market price and block reward
Get the current unconfirmed transaction count

FAQ from MCP Blockchain Query Server

What transport modes are supported?

Both stdio (default) and SSE (Server-Sent Events) are supported. Use --transport sse to enable SSE and specify a port with --port.

How do I install and run the server?

Create a Python virtual environment, install dependencies from requirements.txt, and run python main.py. For SSE mode, append --transport sse --port 8000.

What tools are available?

The server provides 17 tools: get block by hash, get transaction by hash, get address by hash, get block count, get difficulty, get address balance, get hash rate, get average transaction size, get total bitcoins, get probability of finding a block, get 24-hour market price, get block interval, get block reward, get next retarget, get latest hash, get unconfirmed count, and get 24-hour transaction count.

Which blockchain does the server query?

It queries Bitcoin (BTC) data via the Blockchain.com Data and Query APIs.

What runtime dependencies are required?

Python 3, a virtual environment, and the packages listed in requirements.txt are required. The majority of the code in this repository was generated using Grok 3 Beta.