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

• Node.js v20 or higher

Installation & Setup

Running the Server

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

Contributing & Development

Contributions and feature requests are welcome! Please:

• Document your changes clearly

• Submit a pull request or open an issue

Local Development

• Use npm run dev for hot-reloading (if configured)

• Run tests with npm test

Support

• Open an issue

• Join Discord

License

Apache 2.0