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:/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