MCP/Tools/Account/get_usage_report
get_usage_report

Usage report

Free

Credits used over a date range, grouped by client, day, model or type.

How it works

Adds up your usage between two dates (UTC days). Group by brand to bill clients, by model to see what you use most.

Inputs

Name
Type
Required
Description
from
string
optional
Start day, YYYY-MM-DD.
to
string
optional
End day, YYYY-MM-DD.
groupBy
'brand' | 'day' | 'model' | 'type'
optional
How to group.

Returns

{ from, to, groupBy, groups, total }

Examples

Bill clients for October

The agent groups October's usage by brand.

{
  "from": "2026-10-01",
  "to": "2026-10-31",
  "groupBy": "brand"
}