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

# Quotas

> Cap governed LLM spend across workspaces, agents, Gateways, pools, and models

export const quota = "A Quota caps governed LLM spend in USD over a daily or monthly window for a workspace, agent, Gateway, pool, or model. Dome rejects or reroutes metered calls when the budget is exhausted.";

<p>
  {quota}
</p>

Refer to [Quotas](/govern/quotas) for the enforcement model and subjects. Gateway-scoped quotas live under [Gateways](/reference/mcp/gateway#cost-quotas). All tools require workspace context.

## Quotas

### dome\_model\_quota\_list

List LLM cost quotas in the active workspace.

| Parameter | Type | Required | Description   |
| --------- | ---- | -------- | ------------- |
| —         | —    | —        | No parameters |

<Callout icon="key">Requires `gateway.view`.</Callout>

### dome\_model\_quota\_set

Create a USD spend cap. The `subject` decides what the cap covers.

| Parameter    | Type   | Required    | Description                                                                             |
| ------------ | ------ | ----------- | --------------------------------------------------------------------------------------- |
| `subject`    | string | Yes         | `workspace`, `agent`, `act-as`, `pool`, or `model`                                      |
| `limit_usd`  | number | Yes         | Spend cap in US dollars (e.g. `500` or `12.50`)                                         |
| `window`     | string | No          | Reset window: `daily` or `monthly` (default `monthly`)                                  |
| `name`       | string | No          | Optional human-readable label                                                           |
| `model`      | string | Conditional | Model connection name (`subject=model`)                                                 |
| `pool`       | string | Conditional | Pool name (`subject=pool`, or to scope a model quota to one pool)                       |
| `agent`      | string | Conditional | Agent id (`subject=agent`)                                                              |
| `act_as`     | string | Conditional | Verified end-user OIDC subject (`subject=act-as`)                                       |
| `per_caller` | bool   | No          | `subject=model` only: apply the limit independently per agent and per verified end user |
| `disabled`   | bool   | No          | Create disabled; no enforcement until enabled                                           |

<Callout icon="key">Requires `gateway.manage`.</Callout>

```json title="Per-model in-pool budget (drives spill-over)" theme={"system"}
{
  "name": "dome_model_quota_set",
  "arguments": {
    "subject": "model",
    "model": "claude-sonnet",
    "pool": "production",
    "limit_usd": 1000,
    "window": "monthly"
  }
}
```

### dome\_model\_quota\_remove

Remove a cost quota by id. Marked destructive.

| Parameter  | Type   | Required | Description                             |
| ---------- | ------ | -------- | --------------------------------------- |
| `quota_id` | string | Yes      | Quota id (from `dome_model_quota_list`) |

<Callout icon="key">Requires `gateway.manage`.</Callout>

## Next steps

* [Set Usage Limits](/govern/quotas) how-to for the full workflow
* [Pools](/reference/mcp/pools) when per-model budgets should spill to the next member
* [Models](/reference/mcp/models) for the connections quotas cover