cli: align Rust MCP read catalog (#519)

CHANGELOG.md

@@ -4,6 +4,8 @@ Cross-package release notes for relayburn. Package changelogs contain package-le
 
 ## [Unreleased]
 
+- `burn mcp-server` now exposes summary, hotspots, overhead attribution,
+  overhead trimming, and model comparison through validated read-only tools.
 - Pricing recognizes Claude 5 and GPT-5.6 models, prefers first-party tariffs over reseller duplicates, and applies long-context price tiers.
 - `burn hotspots --findings` surfaces unknown model pricing explicitly and ranks unpriced sessions by token volume instead of treating them as $0.00.
 

README.md

@@ -170,16 +170,22 @@ MCP. The server is stdio-only and read-only.
 
 | Option | What it does |
 |---|---|
-| `--session-id <uuid>` | Default session ID used by MCP tools when the caller omits one. |
+| `--session-id <uuid>` | Default session ID used by session cost, summary, and hotspots when the caller omits one. |
 
 | Tool | What it returns |
 |---|---|
 | `burn__sessionCost` | Total USD, tokens, turns, and models for a session. |
+| `burn__fingerprint` | Cheap change-detection fingerprint for the ledger or a session/project scope. |
+| `burn__summary` | Token use and cost by tool and model, with optional session, project, time, and enrichment filters. |
+| `burn__hotspots` | Attribution, grouped hotspots, or findings for expensive and repeated activity. |
+| `burn__overhead` | Instruction-file token overhead and cost by file and section. |
+| `burn__overheadTrim` | Ranked instruction-file trimming recommendations and projected savings. |
+| `burn__compare` | Per-model, per-activity cost and outcome comparison. |
 
 | Example | Result |
 |---|---|
-| `burn mcp-server --session-id <uuid>` | Start a session-scoped stdio MCP server. |
-| `burn mcp-server` | Start a server where tools require explicit session IDs. |
+| `burn mcp-server --session-id <uuid>` | Start a stdio server whose session cost, summary, and hotspots tools default to that session. |
+| `burn mcp-server` | Start an unscoped stdio server; callers can pass filters explicitly, while overhead and compare remain cross-session by design. |
 
 ## `burn state`
 

crates/relayburn-cli/src/cli.rs

@@ -221,18 +221,17 @@ pub struct IngestArgs {
 
 /// Per-command flags for `burn mcp-server`. The stdio MCP server speaks
 /// JSON-RPC 2.0 line-delimited frames over stdin/stdout and exposes the
-/// `burn__sessionCost` read-only tool. Closes #210.
+/// read-only burn MCP tool catalog.
 ///
 /// Global `--ledger-path` (on [`Args`]) is consulted as the SDK ledger
-/// home. `--session-id` registers a default session id so MCP clients
-/// that omit `sessionId` in `tools/call` get a useful answer (the
-/// running agent's own session).
+/// home. `--session-id` registers a default session id so MCP clients that
+/// omit a session selector get a useful answer (the running agent's own
+/// session).
 #[derive(Debug, Clone, ClapArgs)]
 pub struct McpServerArgs {
-    /// Default sessionId to use when `tools/call burn__sessionCost`
-    /// omits the argument. Lets the host wrap the server with the
-    /// running agent's own session id so the agent can self-query
-    /// without knowing it.
+    /// Default sessionId used by sessionCost, summary, and hotspots when
+    /// their session argument is omitted. Lets the host register the running
+    /// agent's own session so it can self-query without knowing the id.
     #[arg(long = "session-id", value_name = "ID")]
     pub session_id: Option<String>,