Usage & fair use

Consile meters tool usage per account and surfaces it in the portal under Abonnement & forbrug. 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:

{
  "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.

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.

Errors & limits

Introduction

Connect an MCP client

API reference

Usage & fair use

Metering

Fair use

​Metering

​Fair use

Metering

Fair use