Docker Hub MCP

Maestro

by github.com/maestro-org · Monitoring

0.0 · 0 reviews

0 installs · 35 tools

A Model Context Protocol (MCP) server exposing Bitcoin blockchain data through the Maestro API platform. Provides tools to explore blocks, transactions, addresses, inscriptions, runes, and other metaprotocol data.

Maestro MCP Server

A Model Context Protocol (MCP) server for interacting with Bitcoin via the Maestro API platform. Provides tools for exploring blocks, transactions, addresses, and more on the Bitcoin blockchain.

Quick Links

Hosted Mainnet: https://xbt-mainnet.gomaestro-api.org/v0/mcp
Hosted Testnet4: https://xbt-testnet.gomaestro-api.org/v0/mcp
API Key Required: Get your Maestro API key
Client Examples: maestro-mcp-client-examples

Getting Started

Requirements

Bun v1.0 or higher

Installation & Setup

# Install dependencies
bun install

# Build the project
bun run build

# Copy and edit environment variables
cp .env.example .env
# Edit .env to add your Maestro API key and any other config

Running the Server

bun run start:http

The server will start on the port specified in your .env (default: 3000).
Access the MCP endpoint at http://localhost:<PORT>/mcp.

Features

🚀 Streamable HTTP MCP server (spec)
🔑 API Key authentication (see .env.example)
📦 Multiple APIs:
Blockchain Indexer
Mempool Monitoring
Market Price
Wallet
Node RPC
🌐 Supported Networks:
Mainnet: API_BASE_URL=https://xbt-mainnet.gomaestro-api.org/v0
Testnet4: API_BASE_URL=https://xbt-testnet.gomaestro-api.org/v0

API Reference & Examples

Server Generation

This server is generated using openapi-mcp-generator:

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

Contributing & Development

Contributions and feature requests are welcome! Please:

Document your changes clearly
Submit a pull request or open an issue

Local Development

Use bun run dev for hot-reloading (if configured)
Run tests with bun test

Support

License

Apache 2.0

get_address_activity List satoshi balance change activity for an address.

get_address_balance Get current satoshi balance for an address (confirmed only).

get_address_balance_historical Get historical satoshi balances per block, with USD valuation.

get_address_brc20 List BRC-20 balances for an address (total and available).

get_address_brc20_transfer_inscriptions List unspent BRC-20 transfer inscriptions at an address.

get_address_inscriptions List inscriptions currently controlled by an address.

get_address_inscription_activity List inscription send/receive/self-transfer activity for an address.

get_address_runes List Rune balances for an address (total and available).

get_address_rune_activity List Rune balance increases/decreases/self-transfers for an address.

get_address_rune_utxos List UTXOs at an address containing Runes.

get_address_statistics Get address stats: tx counts, UTXOs, sat balance, runes/inscriptions flags.

get_address_txs List transactions that spent/produced UTXOs for an address.

get_address_utxos List UTXOs for an address; supports dust and metaprotocol filtering.

get_mempool_address_balance Get address satoshi balance including mempool-aware estimates.

get_mempool_address_runes Get mempool-aware Rune balances for an address.

list_brc20_assets List BRC-20 tickers deployed on-chain.

get_brc20_info Get BRC-20 metadata and current state.

list_supported_dexs List supported DEX identifiers for market endpoints.

get_dex_ohlc Get OHLCV candles for a DEX and symbol.

get_btc_price_by_timestamp Get BTC-USD price at a given UTC timestamp.

get_rune_price_by_timestamp Get Rune price (USD and sats) at a given UTC timestamp.

rpc_chain_info Bitcoin node and chain status from Node RPC.

rpc_mempool_info Current mempool size, usage, fee thresholds, RBF state.

rpc_mempool_transactions List transaction IDs currently in the mempool.

rpc_block_miner_info Get miner metadata for a given block.

rpc_block_volume Get total transaction output volume (sats) for a block.

event_healthcheck Event Manager healthcheck.

event_list_logs List event logs produced by triggers.

event_get_log Get a single event log by id.

event_list_triggers List all triggers.

event_create_trigger Create a new trigger for on-chain events.

event_get_trigger Get a trigger by id.

event_update_trigger Update an existing trigger by id.

event_delete_trigger Delete a trigger by id.

event_list_trigger_condition_options List condition picklist options for triggers.

🥇

Security Tier

Gold

Score
out of 100

Scanned by

orcorus-marketplace-automation

Mar 13, 2026

AI review failed after 1 turns: Error code: 401 - {'error': {'code': '', 'message': '[sk-hPL***S1Z] token quota exhausted !token.UnlimitedQuota && token.RemainQuota = -499 (request id: 202603130937086218489881o44YDMm)', 'type': 'comet_api_error'}}

0.0

0 reviews

No reviews yet — be the first!

Connect →

0.0

★ Rating

Tools

Installs

Configuration

API_KEY_API_KEY required 🔒 password

API_KEY_API_KEY

Configure the connection to Maestro MCP Server

Docker Image

Docker Hub

            mcp/maestro-mcp-server
          

Links

Source Commit

Published by github.com/maestro-org

Similar Servers