Maestro MCP

What is Maestro MCP Server?

Maestro MCP Server is an MCP (Model Context Protocol) server designed to facilitate interaction with the Bitcoin blockchain through the Maestro RPC API. It acts as a bridge, allowing users and applications to explore various aspects of the Bitcoin network, including blocks, transactions, and addresses.

How to use Maestro MCP Server?

To use Maestro MCP Server, you need Node.js v20 or higher. After cloning the repository, install dependencies with npm install, build the project with npm run build, and then copy .env.example to .env to configure your Maestro API key and other settings. You can then start the server using npm run start:http. The server will run on the port specified in your .env file (default: 3000), and the MCP endpoint will be accessible at http://localhost:<PORT>/mcp.

Key Features of Maestro MCP Server

Streamable HTTP MCP server: Supports the streamable HTTP specification for efficient data transfer.
API Key authentication: Ensures secure access to the server and its functionalities.
Multiple APIs: Integrates with various Maestro APIs including Blockchain Indexer, Mempool Monitoring, Market Price, Wallet, and Node RPC.
Supported Networks: Works with both Bitcoin Mainnet and Testnet4.

Use Cases of Maestro MCP Server

Maestro MCP Server can be used for:

Blockchain Exploration: Developers and users can explore Bitcoin blocks, transactions, and addresses programmatically.
Application Development: It serves as a backend for applications that require real-time or historical Bitcoin blockchain data.
Wallet Integration: Facilitates integration with wallet services for managing Bitcoin assets.
Mempool Monitoring: Allows for monitoring unconfirmed transactions in the Bitcoin mempool.

FAQ about Maestro MCP Server

What are the requirements to run Maestro MCP Server? You need Node.js v20 or higher.
How do I get a Maestro API key? You can obtain a Maestro API key from the Maestro documentation website.
Can I use Maestro MCP Server with both Mainnet and Testnet? Yes, it supports both Bitcoin Mainnet and Testnet4.
Where can I find client examples? Client examples are available in the maestro-mcp-client-examples GitHub repository.
How can I contribute to the project? You can contribute by submitting pull requests or opening issues on the GitHub repository. You can also join their Discord for support and discussions.

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

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

License

Apache 2.0

Maestro MCP Overview