Billing, plans, and usage caps

Four tiers: Free (forever), Team ($30/seat/mo), Business ($80/seat/mo), Enterprise. Caps protect both sides — pricing math is grounded in actual per-token costs.

Updated 2026-04-26

Owners can manage the workspace subscription at /settings/billing.

Tiers: - **Free** — $0, forever, no card. 1 GB storage · 100 documents · 50 agent questions/month (Haiku only). Solo evaluation; upgrade to add teammates or more capacity. - **Team** — $30/seat/month (annual: $25). 25 GB/seat · 200 questions/seat/month · 40 Opus reasoning queries/seat/month · 500 PDF extractions/seat/month · webhooks · read-only public REST API. Min 3 seats. - **Business** — $80/seat/month (annual: $65). 100 GB/seat · 1,000 questions/seat/month · unlimited Opus · 2,000 PDF extractions/seat/month · BYO-key encryption · SAML SSO via WorkOS · full public REST API + bulk-ingest. Min 10 seats. - **Enterprise** — custom volume pricing. Unlimited usage · SOC 2 Type II · HIPAA BAA · dedicated CSM. Min 25 seats. Talk to us at hello@kumokodo.ai.

Why caps?

We don't want a surprise AI bill any more than you do. Anthropic and OpenAI bill us per token; without caps one runaway agent loop or one heavy-use power user could push our spend past your subscription, and the only options would be us eating the cost or quietly throttling you. Caps make the math legible: the Team tier's 200 questions/seat/month is sized so a typical-usage seat costs us about $5–6 against the $30 you pay — comfortable margin both ways.

Caps are **load-bearing**. We surface usage on /settings/billing (live bars against the active tier's caps, coloured amber at 70% and red at 90%) and on the dashboard. When you hit a cap:

- **Agent questions** — the chat panel surfaces the cap message ("You've used this month's agent-question budget on the Team plan…") with a one-click "Upgrade plan →" link. New questions stay refused until you upgrade or the calendar month rolls over. - **Opus reasoning** — silently falls back to Haiku for the remainder of the month. You keep getting answers; they're just on the cheaper model. The 18× price difference between Opus ($15 / $75 per Mtok) and Haiku ($0.80 / $4) makes auto-fallback strictly better than refusing the whole request. - **Storage / document count** — uploads refuse with the cap reason. Existing documents stay readable; only new ingest is gated. - **Seats** — invite issuance and acceptance both check the seat cap. An invite issued before the cap was hit can still be revoked manually if it isn't accepted in time.

The dashboard surfaces an amber banner once any cap hits 80% utilization and a red banner at 100% so admins see the upgrade signal before users start hitting walls.

Managing the subscription: - Upgrade or downgrade — click "Manage subscription" on /settings/billing to launch the Stripe Customer Portal. Plan changes are pro-rated; the new caps take effect immediately. - Update payment method — same Customer Portal. - Cancel — Customer Portal. The subscription stays active until the end of the current billing period; access drops back to the Free tier when it expires. - Past invoices — Customer Portal carries every invoice ever issued.

A failed payment automatically marks the subscription as past_due and we surface a banner on /settings/billing. Stripe retries the card per its dunning policy; if everything settles, the banner disappears. If the subscription cancels, we drop the workspace back to Free tier — your data stays untouched, but the caps tighten until you re-subscribe.

For per-event spend (which model, which document, which event drove which row), the workspace cost dashboard at /costs (owner / admin only) is the source of truth. Every cost row pairs 1:1 with the audit-log entry that drove it; if a customer disputes a number, the audit log is the receipt.