Maestro MCP Server

A Model Context Protocol (MCP) server for interacting with Bitcoin via the Maestro API platform. Provides tools for exploring blocks, transactions, addresses, and more on the Bitcoin blockchain.

Quick Links

Hosted Mainnet: https://xbt-mainnet.gomaestro-api.org/v0/mcp
Hosted Testnet4: https://xbt-testnet.gomaestro-api.org/v0/mcp
API Key Required: Get your Maestro API key
Client Examples: maestro-mcp-client-examples

Getting Started

Requirements

Node.js v20 or higher

Installation & Setup

# Install dependencies
npm install

# Build the project
npm run build

# Copy and edit environment variables
cp .env.example .env
# Edit .env to add your Maestro API key and any other config

Running the Server

npm run start:http

The server will start on the port specified in your .env (default: 3000).
Access the MCP endpoint at http://localhost:<PORT>/mcp.

Features

🚀 Streamable HTTP MCP server (spec)
🔑 API Key authentication (see .env.example)
📦 Multiple APIs:
- Blockchain Indexer
- Mempool Monitoring
- Market Price
- Wallet
- Node RPC
🌐 Supported Networks:
- Mainnet: API_BASE_URL=https://xbt-mainnet.gomaestro-api.org/v0
- Testnet4: API_BASE_URL=https://xbt-testnet.gomaestro-api.org/v0

Server Generation

This server is generated using openapi-mcp-generator:

npx openapi-mcp-generator --input openapi-merged.json --output ./ --force --transport streamable-http --port 3000

Contributing & Development

Contributions and feature requests are welcome! Please:

Document your changes clearly
Submit a pull request or open an issue

Local Development

Use npm run dev for hot-reloading (if configured)
Run tests with npm test

Support

Open an issue
Join Discord

License

Apache 2.0

Maestro Bitcoin