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.

• 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

• Node.js v20 or higher

# 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

npm run start:http

• The server will start on the port specified in your .env (default: 3000).
• Access the MCP endpoint at https://localhost:<PORT>/mcp.

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

• Maestro API Postman Workspace
• Client Usage Examples

This server is generated using openapi-mcp-generator:

npx openapi-mcp-generator --input openapi-merged.json --output ./ --force --transport streamable-http --port 3000

Contributions and feature requests are welcome! Please:

• Document your changes clearly
• Submit a pull request or open an issue

• Use npm run dev for hot-reloading (if configured)
• Run tests with npm test

• Open an issue
• Join Discord

Apache 2.0