Maestro MCP Server

A Model Context Protocol (MCP) server for interacting with Bitcoin via the Maestro API platform. This package provides a set of tools for exploring blocks, transactions, addresses, and other aspects of the Bitcoin blockchain.

Installation

Requirements

Node >=20

Deploy

Install:

npm install

Build:

npm run build

Run:

npm start

Server Generation

Generated with openapi-mcp-generator:

npx openapi-mcp-generator --input openapi-merged.json --output ./ force

Configure Claude (Desktop)

Download Claude Desktop here.

Steps (TODO(Jon): update to follow Node based server)

Open Claude Desktop settings
Select Edit Config
Open the Claude App configuration file located at: ~/Library/Application Support/Claude/claude_desktop_config.json and copy the below contents into this file

You will need 3 things:

Absolute path to uv; ie, which uv
Absolute path to mcp-maestro repo
Maestro API key

{
  "mcpServers": {
    "maestro-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/maestro-mcp", "run", "maestro.py"],
      "env": {
        "MAESTRO_BASE_URL": "https://xbt-mainnet.gomaestro-api.org/v0",
        "MAESTRO_API_KEY": "<MAESTRO_API_KEY>"
      }
    }
  }
}

Usage

Restart Claude after any change to either the claude_desktop_config.json or the source code.

Launch Claude Desktop
Locate hammer icon
View available MCP tools
Prompt Claude

"Fetch the latest Bitcoin block"
"Get the blockchain info for Bitcoin"

NOTE: You will need to approve the request within Claude.

Debugging

CLI inspector tool

mcp-cli

Logs

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-maestro-mcp.log

Supported APIs

Blockchain Indexer API
Mempool Monitoring API
Wallet API
Node RPC API

All Maestro API specifications can be found in our Postman workspace.

Contributing

Contributions and feature requests are welcome! Please document clearly as needed. Feel free to submit a pull request or open an issue.

Support

If you are experiencing any trouble with the above, open an issue or reach out on Discord.

License

Apache 2.0

Maestro MCP Server