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
- Mainnet:
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:
- Document your changes clearly
- Submit a pull request or open an issue
Local Development
- Use
npm run devfor hot-reloading (if configured) - Run tests with
npm test