MCP Tools Reference

Model-Facing Capabilities

When CacheLane is installed, it runs a local stdio MCP server. This registers several tools that Claude Code automatically discovers and can execute mid-session to inspect cache state or expand stubs.

cachelane:stats

Returns detailed turn counts, cache-hit ratios, baseline cost units, effective cost units, savings ratios, keepalive pings, and pruner status.

Inputs:

• scope (string, optional): One of "session", "workspace", or "all". Defaults to "session".
• since (string, optional): ISO duration string to filter records.

cachelane:explain

Allows the model (and the user) to inspect the exact region segregation, active breakpoints, and pruning decisions for the latest turn or a requested historical turn.

Inputs:

• turn (integer, optional): The target turn index to query. Defaults to the latest turn.

cachelane:expand

This tool is invoked by Claude Code whenever it encounters a pruned block stub in its context that it needs to access in full.

When called, CacheLane retrieves the block from the local SQLite log, materializes its text, and inserts it back into the suffix of the prompt on the next turn.

Inputs:

• block_id (string, required): The target unique block identifier (8-character hash prefix accepted).