About Maestro MCP Server
Maestro MCP Server is an MCP server for querying Bitcoin data through the Maestro API platform. It covers blocks, transactions and addresses, and offers hosted mainnet and Testnet4 endpoints. It suits developers who want AI assistants to read on-chain Bitcoin information.
Key features
- 01Block, transaction and address queries
- 02Streamable HTTP MCP transport
- 03API key authentication
- 04Mainnet and Testnet4 support
Use cases
- 01Letting an AI assistant check Bitcoin transaction status
- 02Analyzing address and UTXO information
- 03Developing Bitcoin applications against Testnet4
MCP support
This project is an MCP server that exposes Bitcoin on-chain data query tools to MCP clients over Streamable HTTP.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMaestro 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
- Bun v1.0 or higher
Installation & Setup
# Install dependencies
bun install
# Build the project
bun 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
bun 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
bun run devfor hot-reloading (if configured) - Run tests with
bun test
Support
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.