maestro-mcp-server

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

# 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

• Maestro API Postman Workspace
• Client Usage 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:

• 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