tokmeter_search
Search individual API usage records by model substring, provider, project, date range, or cost bounds to investigate specific spikes or expensive calls.
Instructions
Find individual usage records — one per API response — matching a model substring, providers, project, date range and per-record cost bounds. Returns up to limit records (default 25), newest first unless sort_by says cost or tokens, each with time, provider, model, project, token buckets and cost. Use it to investigate a specific spike or an expensive call; for totals use tokmeter_pulse, for per-model or per-project rollups use tokmeter_models or tokmeter_projects. Records exist only while agents keep their transcripts, so the default (all) scope covers the last 14 days.
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_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max records to return (default: 25) | |
| model | No | Filter by model name substring | |
| scope | No | Time scope: today, week (last 7d), month (calendar month), or all (default) | |
| since | No | Start date (YYYY-MM-DD) for custom date range | |
| until | No | End date (YYYY-MM-DD) for custom date range | |
| project | No | Filter by project name/path substring | |
| sort_by | No | Sort by cost (desc), tokens (desc), or time (desc). Default: time | |
| max_cost | No | Maximum cost per record (USD) | |
| min_cost | No | Minimum cost per record (USD) | |
| providers | No | Filter to specific providers (e.g. ['claude-code','cursor']) |