# billing_usage

> Model spend for a month (YYYY-MM), grouped by day, model, pack, agent or connection, with the managed charge.

Model spend for a month (YYYY-MM), grouped by day, model, pack, agent or connection, with the managed charge. Read only.

**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 |
| ---------- | -------------- | ------- |
| `month`    | string or null | `null`  |
| `group_by` | string         | `"day"` |

## Call

The arguments of a `tools/call` request:

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

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