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

• Python >=3.10
• Python MCP SDK >= 1.2.0
• uv

Install UV

curl -LsSf https://astral.sh/uv/install.sh | sh

Setup Virual Environment

# Create a virtual environment
uv venv

# Activate virtual environment
# Linux/MacOS
source .venv/bin/activate
# Windows
# .venv\Scripts\activate

# Install dependencies
uv pip install .

Configure Claude (Desktop)

Download Claude Desktop here.

Steps

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

Debugging

CLI inspector tool

• mcp-cli

Logs

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

Supported Endpoints

• /mempool/addresses/:id/utxos
• /transactions/:id
• /rpc/general/info
• /rpc/block/latest
• /rpc/transaction/:id
• /rpc/transaction/submit
• /assets/runes
• /assets/runes/:id
• /addresses/:id/runes
• /addresses/:id/utxos
• /addresses/:id/runes/:id
• /addresses/:id/txs

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

Support

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