Maestro MCP Server

Interact with the Bitcoin blockchain using the Maestro API to explore blocks, transactions, and addresses.

GitHub

Maestro MCP Server

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.

Quick Links

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

관련 서버