maestro-mcp

maestro-mcp

9
finance

Maestro MCP Server is a platform that allows interactions with the Bitcoin blockchain through the Maestro API. It provides tools for exploring various aspects of Bitcoin's network such as transactions and blocks. The server supports a range of endpoints to facilitate detailed blockchain analysis.

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.

Table of Contents:

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
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/txs

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