# usage

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

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:

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

Source: https://docs.atlanticagenticlabs.com/mcp/tools/usage/