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

# Usage & fair use

> How tool calls are metered, and how the fair-use quota behaves.

Consile meters tool usage per account and surfaces it in the portal under
[Abonnement & forbrug](/portal/abonnement). Usage is also available as a
first-party JSON read.

## Metering

* **One call = one unit** (no per-tool weighting is active today).
* Usage is aggregated **month-to-date**, broken down **by connector** and by tool.

`GET /api/usage` (same Stytch identity as MCP) returns:

```json theme={null}
{
  "usage": {
    "from": "2026-06-01",
    "to": "2026-06-03",
    "totalCalls": 142,
    "totalCostUnits": 142,
    "byConnector": {
      "gsc": { "calls": 120, "costUnits": 120, "byTool": { "top_queries": 64 } },
      "economic": { "calls": 22, "costUnits": 22, "byTool": { "list_customers": 9 } }
    }
  },
  "fairUse": { "withinQuota": true, "used": 142, "limit": 100000, "mode": "off", "month": "2026-06" }
}
```

## Fair use

A fair-use policy limits excessive automated tool calls. It has three modes:

| Mode            | Behaviour                                                                                                                                                   |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `off` (default) | Usage is recorded; nothing is ever blocked.                                                                                                                 |
| `soft`          | Over-limit calls are flagged in the usage record, but **not** blocked. No alerting path is implemented today. The flag is visible in the API response only. |
| `hard`          | Calls beyond the limit are blocked once the quota is exceeded.                                                                                              |

The default monthly quota is **100,000 cost units** (the value of
`FAIR_USE_MONTHLY_QUOTA` when unset). Contact support if you expect to exceed it.

<Note>
  Fair use **fails open**: if the usage store is unavailable, calls are allowed
  (`withinQuota: true`) rather than blocked. Normal usage within your plan is
  included, and you're warned before approaching any limit.
</Note>