tokmeter_cache_efficiency
Measure prompt-caching payoff by period, provider, or project: see cache hit rate, read/write volumes, per-model breakdown, and estimated savings, write premium, and net dollars.
Instructions
Prompt-caching payoff for today, the last 7 days or this month, optionally for one provider or project: cache hit rate, cache read and write volumes, and a per-model breakdown, plus ESTIMATED dollars — savings (cached reads assumed ~90% cheaper than input), the write premium (assumed ~25% over input) and the net. The estimates use the scope's average input price, not each model's card. Use it to judge whether caching pays off; for general token ratios across models, use tokmeter_efficiency.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "tokmeter_cache_efficiency"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Time period to analyze: today, week, or month | |
| project | No | Filter by project name/path substring | |
| provider | No | Filter to a specific provider |