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

• Bun v1.0 or higher

Installation & Setup

# Install dependencies
bun install

# Build the project
bun 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

bun 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

API Reference & Examples

• Maestro API Documentation

• Client Usage Examples

• MCP: Interact with Bitcoin via an LLM

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 bun run dev for hot-reloading (if configured)

• Run tests with bun test

Support

• Open an issue

• Join Discord

License

Apache 2.0