What is maestro-mcp-server CLAUDE.md?

Developer guidance for an MCP server that gives language models tools for querying Bitcoin data through the Maestro API. It covers addresses, assets, blocks, transactions, mempool data, and Bitcoin node operations, with tools generated from an OpenAPI description.

Maintaining Bitcoin data tools, HTTP transport, session handling, request validation, API execution, and code generation from an OpenAPI specification.

It explains how the server turns API endpoints into validated tools and manages HTTP sessions and authentication. This helps contributors change or regenerate the server without losing its connection between the API specification and available tools.

How maestro-org/maestro-mcp-server configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to maestro-org/maestro-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/maestro-org/maestro-mcp-server/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/maestro-org/maestro-mcp-server

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/maestro-org/maestro-mcp-server/claude-md/github.svg)](https://agentmods.dev/instructions/maestro-org/maestro-mcp-server/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/maestro-org/maestro-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/maestro-org/maestro-mcp-server/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/maestro-org/maestro-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/maestro-org/maestro-mcp-server/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,503 This file is loaded in full into every session.

When invoked 1,503 The same file — it is already loaded in full.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01503	$0.01503
Opus 5.5	$0.00601	$0.00601
Sonnet 5.5	$0.00301	$0.00301
Haiku 4.5	$0.00150	$0.00150

Measured 2mo ago against content hash ecde0bb6d6f7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

maestro-mcp-server CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl http://localhost:3001/health

CLAUDE.md · 162 lines

How it starts

The opening of the file, as written. The whole thing — 162 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Maestro MCP Server - Developer Guide

This document provides essential context for working with the Maestro MCP Server codebase.

Overview

This is a Model Context Protocol (MCP) server that provides LLM-accessible tools for interacting with Bitcoin blockchain via the Maestro API platform. It exposes 119 tools covering addresses, assets (BRC20/Runes/Inscriptions), blocks, transactions, mempool data, and Node RPC operations.

Architecture

src/
├── index.ts           # Main server (4400+ lines) - tool definitions, MCP handlers, API execution
└── streamable-http.ts # HTTP transport layer using Hono framework

Key Components

Tool Definition Map (toolDefinitionMap) - Static map of 119 API endpoints translated to MCP tools
Zod Schema Cache (zodSchemaCache) - Pre-compiled validation schemas for all tools
Session Management (MCPStreamableHttpServer.sessions) - Per-session state including auth tokens
HTTP Client (apiClient) - Axios instance with connection pooling

Code Generation

The server is auto-generated from OpenAPI specification:

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

Look for /* MAESTRO OVERRIDE */ comments to find custom modifications that should be preserved when regenerating.

Performance Optimizations (2026-02)

The following optimizations were implemented to improve reliability and performance:

1. Zod Schema Caching

Before: eval() called on every API request to convert JSON Schema → Zod
After: All schemas pre-compiled at startup, cached in zodSchemaCache
Impact: Eliminates ~5-10ms per request

2. Per-Session Authentication

Before: Single bearerAuth string shared across all sessions (bug)
After: Each session stores its own bearerAuth in SessionData
Impact: Fixes correctness issue with multiple concurrent clients

3. HTTP Connection Pooling

Before: New TCP/TLS connection for every API call
After: apiClient with keepAlive: true, 50 max sockets
Impact: Reduced latency for subsequent requests

Read the full file on GitHub · 162 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 162 lines · 1,503 tokens per session scan A ecde0bb6d6f7

Subscribe to this mod's changes

maestro-mcp-server CLAUDE.md is an instructions file published in the GitHub repository maestro-org/maestro-mcp-server (25 stars, last pushed 6mo ago), licensed Apache-2.0. It adds 1,503 tokens to every session, about $0.0060 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Backend and APIs Web3 and blockchain bitcoin blockchain maestro mcp utxo

maestro-mcp-server CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
maestro-mcp-server CLAUDE.mdmaestro-org/maestro-mcp-server	Instructions file	25	6mo ago	Apache-2.0	A	1,503	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

maestro-mcp-server: Instructions file for Claude Code