Billing and usage
Two meters run independently. Tool calls count against your plan, and model traffic accrues spend through Gateway. This page covers the first; Budgets covers the second.
Every call against the MCP endpoint counts, successful or not, and calls made with test API keys count the same as production usage.
The Workforce console has no Billing tab. Plan, usage, and payment method are all under Settings → Billing in the Agent Handler console, on the same organization, and that page is the source of truth. Reaching it needs View billing or Manage billing, which among the built-in roles only Admin carries.
Plans
Caps are enforced at the tool call level, and only the Free plan blocks: cross 2,000 calls in a month and every tool call returns 402 with billing_limit_reached until the cycle rolls over. The dashboard stays accessible; only tool execution stops. Quotas and prices live on the pricing page.
Provisioning employees and your plan
Provisioning employees through SCIM puts an organization on the Employees Pro plan as soon as the first user syncs. There is no button to press: the first IdP-provisioned user landing is what moves it, and the switch is recorded in the Audit trail.
Two exemptions matter, and Workforce is one of them:
- A Workforce organization does not move. Workforce seats are contracted and billed on their own subscription, so the auto-switch is skipped rather than stacking Employees Pro on top of seats you already pay for. Your plan on the billing page stays whatever it was
- An Enterprise contract does not move either. The contract already covers IdP-provisioned employees
Still add a payment method before you turn provisioning on: an organization on Free is asked for a card before it will generate the SCIM token, so it hits that wall on its first attempt rather than at its first employee. Confirm what your seats cost with your account team either way.
Where to see usage
The Plan & usage card on Settings → Billing badges your plan and shows one figure: this month’s calls against your allowance. An Employees Pro organization sees its provisioned user count there instead, and an Enterprise one sees three months of usage history.
That card is deliberately thin, so Tool call logs is where a spike gets explained. The Employees tab under Provisioning carries a usage column per person when you need to know whose calls those were.
For model spend rather than tool calls, Insights reports cost per call, spend by Group, model, and vendor, and how much routing saved you, and its findings name the specific changes worth making.
Upgrading
From the billing page, click Upgrade plan on Free or Manage plan on a paid plan, pick a Pro tier, and add a payment method. Choosing Enterprise in the same dialog requests a demo rather than switching you: contact sales. Custom contracts cover scoped quotas, dedicated support, and non-default terms such as data retention, region pinning, or a custom security review.
Stripe handles payments, and the dialog is Stripe’s own pricing table. Card updates are immediate and the next charge runs against the new card. For SEPA, ACH, or invoice-based billing, talk to sales: self-serve cards cover Free and Pro, and Enterprise contracts often run on invoice.
Approaching the limit
Only the Free plan blocks, so this is a Free-plan problem. Two options, in the order most teams reach for them:
- Upgrade. Fastest path, effective immediately, and moves you from blocking to billed overage
- Audit usage. A misconfigured agent or one runaway employee can dominate a month. Tool call logs and the Employees tab show where the calls are going
Model spend has its own controls. Cap it with Budgets rather than by raising your tool call plan.
Cancelling
Manage plan → Switch to free moves you to Free straight away, and the confirmation dialog says so: you lose Pro behavior immediately but are still billed for the usage you have already run this month. Existing data is retained, so you can resume on the same plan by upgrading again.
For full data deletion with no resume path, contact support.
Next
Cap what each Group can spend on models with Budgets.