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.

• Node >=20

Install:

npm install

Build:

npm run build

Run:

npm start

Generated with openapi-mcp-generator:

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

Download Claude Desktop here.

1. Open Claude Desktop settings

   

2. Select Edit Config

   

3. 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:

1. Absolute path to uv; ie, which uv
2. Absolute path to mcp-maestro repo
3. 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": ""
      }
    }
  }
}

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

1. Launch Claude Desktop

2. Locate hammer icon

3. View available MCP tools

4. Prompt Claude

• "Fetch the latest Bitcoin block"

• "Get the blockchain info for Bitcoin"

  

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

• mcp-cli

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

• Blockchain Indexer API
• Mempool Monitoring API
• Wallet API
• Node RPC API

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

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

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

Apache 2.0