Skip to main content
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 by default (some tools may be weighted).
  • 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": 10000, "mode": "off", "month": "2026-06" }
}

Fair use

A fair-use policy guards against runaway automation. It has three modes:
ModeBehaviour
off (default)Usage is recorded; nothing is ever blocked.
softOver-limit is flagged but not blocked.
hardCalls beyond the limit are blocked once the quota is exceeded.
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.