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

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

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 npm run dev for hot-reloading (if configured)
  • Run tests with npm test

Support

License

Apache 2.0

Related Servers