Usage & fair use

​

What counts

• One tool call is one unit. No tool is weighted differently today.
• Every call to a connector tool counts, whether it succeeds or not. That includes calls with invalid arguments, calls the provider rejects, and calls refused because the organization has no subscription, the user has no seat, the tool is not enabled for the user or the provider account is not connected.
• Not counted: initialize, tools/list, the Concierge tools on /mcp, connect_account, requests rejected with HTTP 400, 401 or 429, and calls whose tool name does not carry the endpoint’s connector prefix (answered with Unknown tool.).
• Usage is counted per day in UTC and broken down by connector and by tool. The monthly totals and the fair-use quota follow the calendar month in UTC. An extra portal of a connector is counted under its own id, for example economic-2.

​

Read usage from the API

GET https://mcp.consile.ai/api/usage?from=2026-09-01&to=2026-09-30

• Send both parameters or neither. Only one of them returns 400.
• The days must exist in the calendar, from must not be after to, and the period can be at most 92 days, both ends included. Anything else returns 400 with {"error":"invalid_window"}. A period is never adjusted for you.
• The organization always comes from the access token. The parameters only choose the period.

{
  "usage": {
    "tenantId": "<your organization id>",
    "from": "2026-10-01",
    "to": "2026-10-31",
    "totalCalls": 142,
    "totalCostUnits": 142,
    "totalFailures": 3,
    "byConnector": {
      "gsc": {
        "calls": 120,
        "costUnits": 120,
        "failures": 0,
        "byTool": { "top_queries": 64, "top_pages": 56 },
        "byDay": {
          "2026-10-02": { "calls": 70, "failures": 0 },
          "2026-10-05": { "calls": 50, "failures": 0 }
        }
      },
      "economic": {
        "calls": 22,
        "costUnits": 22,
        "failures": 3,
        "byTool": { "list_customers": 9, "get_customer": 13 },
        "byDay": {
          "2026-10-05": { "calls": 22, "failures": 3 }
        }
      }
    }
  },
  "fairUse": { "withinQuota": true, "used": 142, "limit": 100000, "mode": "<mode>", "month": "2026-10" }
}

• from and to are the period that was read. Without parameters they are the first and last day of the current month in UTC, not the date of the request.
• totalCalls and calls include failed calls. byTool holds the number of calls per tool, keyed by the tool name without the connector prefix.
• totalFailures and failures count the calls that did not succeed: calls that returned an error and calls that were refused, for example because the user has no seat or the account is not connected.
• byDay holds calls and failed calls per UTC day for the connector. It only contains days with at least one call. A day that is missing had no calls.
• A connector with no calls in the period is not in byConnector.
• totalCostUnits and costUnits equal the number of calls today, because every call costs one unit.
• fairUse always describes the current month, whatever period you ask for.
• A missing or invalid token returns 401 with {"error":"unauthorized"}.
• The endpoint is rate limited. Over the limit it returns 429 with Retry-After: 1 and {"error":"rate_limited"}. The current limits are in Errors & limits.
• Browsers may only call it from the Consile portal, so call it from a server-side process.

​

Fair use