Maestro MCP Server

February 2, 2026 · View on GitHub

CI

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.

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

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:

Local Development

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

Support

License

Apache 2.0