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

Warning
If you build the server from scratch using the above command, you may need to update the API_KEY variable name to match the one used in the Claude config.json, as this variable can be autogenerated.

Contact support if you experience any issues.

Configure Claude (Desktop)

1. Download Claude Desktop here.

2. Open Claude Desktop settings

   

3. Select Edit Config

4. Open the Claude App configuration file located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Copy the below contents into this config file.

Local-scoped MCP

After cloning the repo, the server files are stored and sourced locally on your machine.

You will need 3 things:

1. Absolute path to npm; ie, which npm
2. Absolute path to maestro-mcp-server repo
3. Maestro API key

{
  "mcpServers": {
    "maestro-mcp-server": {
      "command": "/ABSOLUTE/PATH/TO/node",
      "args": ["/ABSOLUTE/PATH/TO/maestro-mcp-server/src/index.ts"],
      "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.

1. Launch Claude Desktop

2. Locate the tools icon

3. Select maestro-mcp-server

4. View available MCP tools

5. 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/maestro-mcp-server.log

Supported APIs

• Blockchain Indexer API
• Mempool Monitoring API
• Market Price 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