MCP Blockchain Query Server

[!WARNING]

Majority of the code in this repository was generated using Grok 3 Beta

Model Context Protocol server providing tools for querying BTC data via Blockchain Data and Query APIs.

Demo

https://github.com/user-attachments/assets/b270979b-b22f-467c-bcb4-54bd48504073

Features

• Supports both stdio and SSE transports
• Available 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
• Get 24-hour transaction count

Installation

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Running

Run in stdio mode (default):

$ python main.py

Run in SSE mode:

$ python main.py --transport sse --port 8000

CLI Arguments:

• --port: Port number for SSE transport (default: 8000)
• --transport: Transport type (stdio or sse, default: stdio)