Get usage
get_usageAccount spend grouped by project (job), agent, key, provider, trace, tool, day or tag: (e.g. tag:slot), optionally filtered by tags, key or job. Rows for keys, jobs and tags include their monthly limit.
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": "get_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | Only runs with this job (project_id) | |
| key | No | Only runs made with this key id | |
| tags | No | Only runs with all these tags, e.g. {"project": "ai-influencers"} | |
| group | No | How to group usage: project (job), agent, key, provider, trace, tool, day or tag:<name>, e.g. tag:slot. | |
| since | No | YYYY-MM-DD; default the 1st of this month (UTC) | |
| until | No | YYYY-MM-DD, exclusive |