brk_mcp

Model Context Protocol (MCP) server for Bitcoin on-chain data.

What It Enables

Expose BRK's query capabilities to AI assistants via the MCP standard. LLMs can browse metrics, fetch datasets, and analyze on-chain data through structured tool calls.

Key Features

Tool-based API: 8 tools for metric discovery and data retrieval
Pagination support: Browse large metric catalogs in chunks
Self-documenting: Built-in instructions explain available capabilities
Async: Full tokio integration via AsyncQuery

Available Tools

Tool	Description
`get_metric_count`	Count of unique metrics
`get_vec_count`	Total metric × index combinations
`get_indexes`	List all index types and variants
`get_vecids`	Paginated list of metric IDs
`get_index_to_vecids`	Metrics supporting a given index
`get_vecid_to_indexes`	Indexes supported by a metric
`get_vecs`	Fetch metric data with range selection
`get_version`	BRK version string

Usage

let mcp = MCP::new(&async_query);

// The MCP server implements ServerHandler for use with rmcp
// Tools are auto-registered via the #[tool_router] macro

Integration

The MCP server is integrated into brk_server and exposed at /mcp/sse endpoint for SSE-based MCP transport.

Built On

brk_query for data access
brk_rmcp for MCP protocol implementation

1.4 KiB Raw Blame History Unescape Escape