cercano-stats

name	cercano-stats
description	View Cercano usage statistics and cloud token savings. Shows total requests, tokens processed locally, cloud tokens reported by the host, percentage kept local, and breakdowns by tool, model, and day.
compatibility	Requires Cercano server running with telemetry enabled.

Cercano Stats

View usage statistics and cloud token savings from Cercano's local inference.

Important: Display the result

MCP tool results may not be visible to the user in the terminal. After calling the tool, you MUST output the full tool result text verbatim in your response so the user can see it.

MCP Tool

Tool name: cercano_stats

Parameters

No parameters required.

Output

Returns a markdown-formatted report including:

• Total requests processed locally
• Local tokens (input + output)
• Cloud tokens (if host-reported via cercano_submit_usage)
• Kept local percentage (when cloud data is available)
• Estimated cloud tokens saved (when no cloud data reported)
• Breakdown by tool (e.g. summarize, extract, classify)
• Breakdown by model (e.g. qwen3-coder, gemma3:4b)
• Recent activity (last 7 days)

Examples

Get usage stats:

{}

Sample output:

## Cercano Usage Statistics

**Total requests:** 42
**Local tokens:** 18,500 (15,200 in, 3,300 out)
**Estimated cloud tokens saved:** 18,500

### By Tool
- cercano_summarize: 20 calls, 12,000 tokens
- cercano_extract: 15 calls, 4,500 tokens
- cercano_classify: 7 calls, 2,000 tokens

### By Model
- qwen3-coder: 42 calls, 18,500 tokens

### Recent Activity
- 2026-03-24: 12 calls, 5,200 tokens
- 2026-03-23: 30 calls, 13,300 tokens