> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Report how much Syrto AI usage the signed-in user has spent recently, across four time windows.

`syrto_get_usage` reports how much Syrto AI usage the signed-in user has spent recently. It costs nothing to call.

Consumption is measured in **consumption units (CU)**.

## Use this tool to

* Answer "what have I spent?", "how much has this work cost?", or "how much usage have I been getting through?"

## Arguments

This tool takes no arguments.

<Note>
  `syrto_get_usage` is scoped to a signed-in user. A connection authenticated with an organization API key has no user attached, so the tool is not offered on that connection at all.
</Note>

## Returns

<ResponseField name="unit" type="string">
  The unit every figure is counted in - consumption units (CU).
</ResponseField>

<ResponseField name="since_hour" type="object | null">
  Consumption since the top of the previous hour. This is the shortest window the data supports.
</ResponseField>

<ResponseField name="today_utc" type="object | null">
  Consumption since 00:00 **UTC** today - a UTC day, not a local one.
</ResponseField>

<ResponseField name="last_7_days" type="object | null">
  Consumption over the last 7 days.
</ResponseField>

<ResponseField name="last_30_days" type="object | null">
  Consumption over the last 30 days.
</ResponseField>

<ResponseField name="attribution" type="string">
  Whose consumption these figures are, and their limits.
</ResponseField>

Each window carries:

<ResponseField name="consumption_units" type="integer">
  Consumption units spent in that window.
</ResponseField>

<ResponseField name="start" type="string">
  Start of the window (UTC, inclusive), floored to the hour.
</ResponseField>

<ResponseField name="end" type="string">
  End of the window (UTC) - the time of the call.
</ResponseField>

## How to read the figures

* **Every window is the signed-in user's own consumption**, never the organization's total. Colleagues and automated integrations consume from the same allowance.
* **These are not a bill, an invoice, or a remaining balance.** They are consumption already recorded. For the organization's usage and allowance, an administrator can open the [Syrto dashboard](https://app.syrto.ai).
* **Very recent calls may not be counted yet.** Usage events are buffered, so a call made moments ago may not appear.
* **There is no figure for "this conversation".** The server sees individual tool calls and cannot tell where one piece of work starts or ends; `since_hour` is the closest available answer.
* The windows are UTC and floored to the hour, so "today" means since 00:00 UTC, which may not line up with a local day. Each window reports the `start` it was actually measured from.

## Example

```json theme={null}
{}
```

**Response (abbreviated):**

```json theme={null}
{
  "result": {
    "unit": "consumption units (CU)",
    "since_hour": {
      "consumption_units": 14,
      "start": "2026-09-13T18:00:00+00:00",
      "end": "2026-09-13T18:42:07+00:00"
    },
    "today_utc": {
      "consumption_units": 96,
      "start": "2026-09-13T00:00:00+00:00",
      "end": "2026-09-13T18:42:07+00:00"
    },
    "last_7_days": { "consumption_units": 611, "start": "2026-09-06T18:00:00+00:00", "end": "2026-09-13T18:42:07+00:00" },
    "last_30_days": { "consumption_units": 2384, "start": "2026-08-14T18:00:00+00:00", "end": "2026-09-13T18:42:07+00:00" },
    "attribution": "These figures are your own consumption, not your organization's total - colleagues and any automated integrations consume from the same allowance. Very recent calls may not be counted yet."
  },
  "note": "Syrto data summary. More metrics, benchmarks, and insights are available at https://www.syrto.ai",
  "source_url": "https://app.syrto.ai"
}
```