Bitcoin MCP Server

A Model Context Protocol (MCP) server that provides real-time Bitcoin blockchain data by querying the mempool.space API.

Features

This MCP server offers five specialized tools for querying Bitcoin blockchain data:

🔍 Address Tools

`get-address-stats`

Get basic statistics for any Bitcoin address.

Input:

address (string): Bitcoin address to query

Output:

Chain statistics (funded/spent amounts, transaction counts)
Mempool statistics (pending transactions)

Example:

Address: 1wiz18xYmhRX6xStj2b9t1rwWX4GKUgpv

Chain Stats:
- Funded TXOs: 10
- Funded Sum: 150.07686949 BTC
- Spent TXOs: 5
- Spent Sum: 150.07599040 BTC
- Total Transactions: 12

Mempool Stats:
- Pending TXOs: 0
- Pending Sum: 0.00000000 BTC
- Pending Transactions: 0

`get-address-transactions`

Get transaction history for a Bitcoin address.

Input:

address (string): Bitcoin address to query
limit (optional, number): Number of transactions to return (1-50, default: 10)

Output:

List of recent transactions with status, dates, fees, and sizes

`get-address-utxos`

Get current UTXOs (unspent transaction outputs) for a Bitcoin address.

Input:

address (string): Bitcoin address to query
limit (optional, number): Number of UTXOs to return (1-50, default: 10)

Output:

List of current UTXOs with amounts, confirmation status, and dates

🔗 Transaction Tools

`get-transaction`

Get detailed information about a specific Bitcoin transaction.

Input:

txid (string): Transaction ID (hash) to query

Output:

Complete transaction details including:
- Basic info (version, size, weight, fee)
- Confirmation status and block information
- Input and output details with amounts and addresses

🧱 Block Tools

`get-block`

Get information about a specific Bitcoin block.

Input:

block_height (number): Block height to query

Output:

Block details including:
- Hash, version, merkle root
- Previous block hash and timestamp
- Size, weight, and transaction count
- Fee statistics

Installation

Clone this repository:

git clone <repository-url>
cd bitcoin-mcp

Install dependencies:

npm install

Build the project:

npm run build

Usage

Running the Server

Start the MCP server:

npm start

The server runs on stdio and can be connected to any MCP-compatible client.

Example Queries

Here are some example queries you can make with this MCP server:

Get Address Statistics

{
  "tool": "get-address-stats",
  "arguments": {
    "address": "1wiz18xYmhRX6xStj2b9t1rwWX4GKUgpv"
  }
}

Get Recent Transactions

{
  "tool": "get-address-transactions",
  "arguments": {
    "address": "1wiz18xYmhRX6xStj2b9t1rwWX4GKUgpv",
    "limit": 5
  }
}

Get Transaction Details

{
  "tool": "get-transaction",
  "arguments": {
    "txid": "15e10745f15593a899cef391191bdd3d7c12412cc4696b7bcb669d0feadc8521"
  }
}

Get Block Information

{
  "tool": "get-block",
  "arguments": {
    "block_height": 857808
  }
}

API Endpoints

This MCP server uses the following mempool.space API endpoints:

GET /api/address/{address} - Address statistics
GET /api/address/{address}/txs - Address transaction history
GET /api/address/{address}/utxo - Address UTXOs
GET /api/tx/{txid} - Transaction details
GET /api/block/{height} - Block information

Data Format

All amounts are displayed in BTC (converted from satoshis) for better readability. Timestamps are converted to ISO format for easy parsing.

Error Handling

The server includes comprehensive error handling:

Network errors are caught and reported with descriptive messages
Invalid addresses or transaction IDs return appropriate error messages
Rate limiting and API errors are handled gracefully

Dependencies

@modelcontextprotocol/sdk - MCP SDK for server implementation
superagent - HTTP client for API requests
zod - Schema validation for tool parameters

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Tools

Provides real-time Bitcoin blockchain data by querying the mempool.space API, offering tools to get address statistics, transaction history, UTXOs, transaction details, and block information.

Related MCP Servers

Cryptocurrency Market Data MCP Server
Nayshins
A
security
A
license
A
quality
Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
Last updated -
7
52
Python
MIT License
MCP Etherscan Server
crazyrabbitLTC
A
security
A
license
A
quality
Facilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.
Last updated -
6
10
21
TypeScript
MIT License
Binance MCP Server
qeinfinity
A
security
A
license
A
quality
A server implementation that streams real-time Binance market data (spot and futures) via WebSockets, enabling applications to receive and process cryptocurrency market information through the Model Context Protocol.
Last updated -
6
361
16
TypeScript
MIT License
MCP Etherscan Server
5ajaki
A
security
A
license
A
quality
Provides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.
Last updated -
6
10
1
TypeScript
MIT License

View all related MCP servers

Bitcoin MCP Server