Access Bitcoin Data via Maestro API
Maestro MCP Server gives AI agents Bitcoin blockchain access via Maestro's API: blocks, transactions, addresses, and mempool data.
20250623.2_01f4bbeAdd to Favorites
Why it matters
Integrate with the Bitcoin blockchain by leveraging the Maestro API platform. This asset provides a streaming HTTP server for accessing blockchain data, mempool information, market prices, and node RPCs.
Outcomes
What it gets done
Connect to the Maestro API for Bitcoin data access.
Explore blocks, transactions, and addresses on the Bitcoin blockchain.
Monitor the Bitcoin mempool and market prices.
Interact with Bitcoin node RPCs.
Source
Get it from source
Spark does not host a copy of it.
Open sourceReports
Agent outcome reports
No reports yet
Overview
Maestro MCP Server
Maestro MCP Server gives AI agents Bitcoin blockchain access through Maestro's API: blocks, transactions, mempool, market price, wallet, and node RPC data. Use it when an AI agent needs to query or act on Bitcoin blockchain data through Maestro's API, on mainnet or testnet.
What it does
Maestro MCP Server is a streamable-HTTP MCP server, generated from Maestro's OpenAPI spec via openapi-mcp-generator, that gives an AI agent access to Bitcoin blockchain data and operations through the Maestro API platform. It lets an agent explore blocks, transactions, addresses, and more on Bitcoin, and can run against either Maestro's hosted mainnet endpoint or its hosted Testnet4 endpoint without you standing up your own server.
When to use - and when NOT to
Use it when you want an AI agent to query Bitcoin blockchain data, monitor the mempool, check market price, work with wallets, or issue node RPC calls, either against real Bitcoin funds on mainnet or safely against Testnet4 for development. It requires a Maestro API key, obtained from Maestro's own documentation, passed via environment variable for authentication; there is no free-standing mode without one. You can point at the hosted endpoints directly instead of running your own server, which is the fastest path if you already have an API key. It is released under the Apache 2.0 License.
Capabilities
The server groups its functionality by Maestro's underlying APIs rather than exposing a small fixed toolset: a Blockchain Indexer API for exploring blocks, transactions, and addresses; a Mempool Monitoring API for unconfirmed-transaction visibility; a Market Price API for current Bitcoin pricing; a Wallet API; and a Node RPC API for direct node-level calls. Because the whole server is generated from Maestro's OpenAPI spec, its individual tool surface tracks whatever operations that spec exposes rather than a small, separately documented, hand-picked list.
How to install
Requires Bun v1.0 or higher. From source:
bun install
bun run build
cp .env.example .env
Edit .env to add your Maestro API key and any other configuration, then start the HTTP server:
bun run start:http
The server listens on the port set in .env, defaulting to 3000, with the MCP endpoint at http://localhost:PORT/mcp. Alternatively, skip self-hosting entirely and point your MCP client at Maestro's hosted mainnet or testnet4 endpoint directly, supplying your API key for authentication either way.
Who it's for
Developers building AI agents that need to read or act on Bitcoin blockchain data - blocks, transactions, addresses, mempool state, market price, or wallet and node operations - without hand-writing calls against Maestro's REST API.
Source README
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
- 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
FAQ
Common questions
Discussion
Questions & comments ยท 0
Sign In Sign in to leave a comment.