get_usage

Return current-period usage counters for the authenticated tenant: project count vs quota, API token count vs quota, and model-run minutes consumed in the current UTC calendar month. Use this to answer ‘am I close to a limit?’ without a separate REST round-trip. Returns: projects_used (int), projects_quota (int), tokens_used (int), tokens_quota (int), run_minutes_used_this_month (float), run_minutes_quota (int|null), reset_date_iso (str ISO-8601).

read-only · idempotent

Parameters

This tool takes no parameters.

Returns

Returns a structured object. Top-level fields:

• projects_used (integer)
• projects_quota (integer)
• tokens_used (integer)
• tokens_quota (integer)
• run_minutes_used_this_month (number)
• run_minutes_quota (null)
• reset_date_iso (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_usage",
  "arguments": {}
}

Response

{
  "projects_used": 3,
  "projects_quota": 10,
  "tokens_used": 2,
  "tokens_quota": 5,
  "run_minutes_used_this_month": 12.5,
  "run_minutes_quota": null,
  "reset_date_iso": "2026-06-01T00:00:00+00:00"
}

Notes

• Module: Billing
• Requires authentication via API token or Auth0 JWT.