GitHub - maestro-org/maestro-mcp-server: Maestro MCP Server for Bitcoin (original) (raw)

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.

This runs as MCP Streamable HTTP server.

Installation

Requirements

Node >=20

Deploy

Install:

Build:

Run:

Server Generation

Generated with openapi-mcp-generator:

npx openapi-mcp-generator --input openapi-merged.json --output ./ --force --transport streamable-http --port 3000

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)

Download Claude Desktop here.
Open Claude Desktop settings
Select Edit Config
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:

Absolute path to npm; ie, which npm
Absolute path to maestro-mcp-server repo
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": "" } } } }