usage

Model usage, tokens and cost, grouped by model, pack, task or day.

Role: viewer and above (any person, AAL staff, machine key).

Acts: no. It only reads; nothing an AI agent calls through MCP approves, pays, or changes a limit.

Inputs

Input	Type	Default
since	string or null	null
until	string or null	null
group_by	string	"day"

Call

The arguments of a tools/call request:

{
  "name": "usage",
  "arguments": {}
}