Maestro MCP Server
by
Provides a streamable HTTP Model Context Protocol server for interacting with Bitcoin via the Maestro API, enabling exploration of blocks, transactions, addresses, and additional blockchain data.
Maestro MCP Server Overview
What is Maestro MCP Server about?
The server implements a Model Context Protocol (MCP) endpoint that talks to the Maestro API platform, allowing clients—especially LLM‑driven applications—to query Bitcoin mainnet or testnet data such as blocks, transactions, UTXOs, mempool status, market prices, wallet balances, and node RPC calls.
How to use Maestro MCP Server?
- Prerequisites – Install Node.js v20+.
- Installation – Clone the repository, run
npm install. - Configuration – Copy
.env.exampleto.envand add your Maestro API key (API_KEYor the variable name used in the template). - Start the server – Execute
npm run start:http(or via npx as shown inserverConfig). The MCP endpoint becomes available athttp://localhost:<PORT>/mcp. - Consume the API – Send MCP‑formatted JSON requests to the
/mcppath; responses stream back according to the MCP spec.
Key Features
- Streamable HTTP transport compliant with the MCP specification.
- API‑key based authentication.
- Bundles multiple Maestro services: blockchain indexer, mempool monitor, market price feed, wallet utilities, and raw node RPC.
- Supports both Mainnet and Testnet4 via configurable
API_BASE_URL. - Generated from an OpenAPI definition using
openapi-mcp-generator. - Ready‑made client examples in the companion
maestro-mcp-client-examplesrepo.
Use Cases
- Building LLM agents that need up‑to‑date Bitcoin blockchain information.
- Developing lightweight Bitcoin explorers or dashboards without running a full node.
- Integrating real‑time market price and mempool data into trading bots.
- Providing wallet balance checks and transaction broadcasting for web or mobile apps.
- Automating blockchain analytics pipelines that query historical block and UTXO data.
FAQ
Q: Do I need to run my own Bitcoin node?
A: No. The server proxies requests to Maestro’s hosted API endpoints.
Q: Which networks are supported?
A: Mainnet (https://xbt-mainnet.gomaestro-api.org/v0) and Testnet4 (https://xbt-testnet.gomaestro-api.org/v0).
Q: How is authentication handled?
A: By providing your Maestro API key in the .env file; the server validates it on each request.
Q: Can I run the server in production?
A: Yes, after configuring a proper port, environment variables, and optionally TLS termination in front of the Node.js process.
Q: Where can I find client libraries?
A: See the maestro-mcp-client-examples repository linked in the README.
Maestro MCP Server's 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
- 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
Support
License
Maestro MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Maestro MCP Server's Information
- Author
- maestro-org
- Category
- Finance & Payments
- Language
- JavaScript
- License
- Apache License 2.0
- Version
- v1.0.0
- Stars
- 18
- Updated
- 2 months ago
Configuration
{
"mcpServers": {
"maestro-mcp-server": {
"command": "npx",
"args": [
"maestro-mcp-server",
"start:http"
],
"env": {
"API_KEY": "<YOUR_API_KEY>"
}
}
}
}Claude Code (Terminal)
claude mcp add maestro-mcp-server npx maestro-mcp-server start:httpConfigure Clients
Similar MCP Servers like Maestro MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Stripe Agent Toolkit
by stripe
Integrates Stripe's APIs into LLM‑driven agent workflows via Python and TypeScript libraries, exposing tool definitions compatible with Model Context Protocol for seamless function calling.
Goat
by goat-sdk
Enables AI agents to send and receive payments, purchase goods and services, execute investment strategies, tokenize assets, and obtain financial insights by leveraging blockchains, stablecoins, and wallets.
Financial Datasets MCP Server
by financial-datasets
Provides access to income statements, balance sheets, cash flow statements, stock prices, market news, and cryptocurrency data through MCP tools for AI assistants.
Alpaca MCP Server
Officialby alpacahq
Enables large language models to trade stocks and options, retrieve real‑time and historical market data, and manage portfolios using plain English commands through a local or remote MCP server.
Xero MCP Server
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
Sec Edgar Mcp
by stefanoamorelli
Provides an MCP server that connects AI models to SEC EDGAR filings, enabling real‑time retrieval of company filings, financial statements, and insider‑trading data with exact XBRL precision and verifiable filing references.
MetaTrader MCP Server
by ariadng
Enables AI LLMs to execute trades on the MetaTrader 5 platform through the Model Context Protocol.
Alpha Vantage MCP Server
Officialby calvernaz
Provides access to Alpha Vantage stock market data via an MCP server, supporting stdio and HTTP streaming modes with optional OAuth 2.1 authentication.
Freqtrade Mcp
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with MCP, exposing its REST API as tools for AI agents to perform automated trading operations.