Skip to main content

​
Model Context Protocol (MCP)

The Maestro MCP Server is a Model Context Protocol implementation that enables AI agents and LLMs to interact with Bitcoin blockchain data through the Maestro API. It acts as a bridge, translating natural language queries into blockchain API calls via a standardized streamable HTTP protocol.

​
Available Services

The MCP server exposes five Maestro API service categories:
ServiceDescription
Blockchain IndexerQuery blocks, transactions, and historical chain data
Mempool MonitoringTrack pending and unconfirmed transactions
Market PriceAccess real-time Bitcoin pricing information
WalletAddress lookups, balance queries, and UTXO management
Node RPCDirect Bitcoin node interaction capabilities

​
Setup

​
Prerequisites

​
Installation

git clone https://github.com/maestro-org/maestro-mcp-server.git
cd maestro-mcp-server
bun install
bun run build

​
Configuration

cp .env.example .env
Edit .env to add your Maestro API key and select a network:
NetworkBase URL
Mainnethttps://xbt-mainnet.gomaestro-api.org/v0
Testnet4https://xbt-testnet.gomaestro-api.org/v0

​
Launch

bun run start:http
The MCP endpoint is accessible at http://localhost:3000/mcp.

​
Client Examples

The maestro-mcp-client-examples repository provides working integration examples:
ExampleDescription
basic-streamablehttp-clientRaw streamable HTTP transport connection to the MCP server
ClaudeIntegration with Claude AI for natural language blockchain queries
CursorConfiguration for using Maestro MCP in the Cursor editor

​
Resources

Maestro MCP Server

Source code, full documentation, and setup instructions.

Client Examples

Working examples for Claude, Cursor, and raw HTTP clients.