Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chatblocks.ai/llms.txt

Use this file to discover all available pages before exploring further.

ChatBlocks has three plans. Free is the trial-everything tier with hard caps that prevent runaway cost. Builder is the single paid tier for solo operators. Enterprise is a manual flip we do for customers with custom requirements.

At a glance

PlanPriceBest for
Free$0Trying the platform; hand-authoring blocks with your own agent.
Builder9/monthor9 / month or 89 / yearSolo operators running scheduled agents and AI-generated blocks.
EnterpriseContact usTeams, custom caps, non-Stripe billing.
The plan literal on workspaces.plan is one of "free" | "builder" | "enterprise". Enterprise is set manually by us — there’s no Stripe subscription behind it.

Per-resource caps

These are the v1.4 limits (source: apps/web/convex/lib/limits.ts):
ResourceFreeBuilderEnterprise
Blocks1010010,000
Canvases2201,000
Scheduled runs15500
Data sources (per type)110100
BYOK keys0350
Workspace members1unlimitedunlimited
Builds per month1001,000100,000
AI-generated blocks per month03010,000
MCP requests per minute606006,000
A few notes:
  • Data sources cap is per type. Free can have 1 Stripe + 1 Postgres + 1 webhook + 1 outbound MCP (4 total).
  • BYOK = 0 on Free. No scheduled runs and no blocks.create AI generation. You can still hand-author blocks with your own agent (your agent’s LLM tokens, not ours).
  • Builder members are read-only by default. Builder is the single-operator model: the workspace owner has write powers, co-members are viewers. See Workspaces → Builder co-member model.

What Builder unlocks vs Free

Scheduled runs

Builder-only. Cron-driven agent loops that wake up, decrypt your BYOK key, and write to your blocks.

`blocks.create`

Builder-only. AI block generation streamed over MCP. Free path: hand-author via blocks.init + setFiles + build + publish.

BYOK keys

Builder gives you 3 keys; Free gives you 0. BYOK is the substrate for any LLM call billed to you, not the platform.

Higher caps

100 blocks / 20 canvases / 5 schedules / 10 per-type data sources on Builder, all tighter on Free.

Builder details

Pricing. 9/monthor9 / month or 89 / year. Annual saves ~18% (one month free). Both are billed via Stripe. Trial. Every new Builder subscription comes with a 14-day free trial. Card is required up-front (Stripe Checkout); trial converts to paid on day 15 unless you cancel in the Customer Portal. Refund policy. No refunds — the trial is the refund. This is shown on the Stripe Checkout page itself via custom_text.submit.message:
14-day free trial included. All sales final after the trial.
See Trial and portal for the full mechanics. Plan switching. Monthly ↔ annual switch lives in the Stripe Customer Portal. We don’t surface a UI for it; the portal does the proration math.

Enterprise

Enterprise is for:
  • Teams that need write access for multiple members. Builder’s single-operator-write model is intentional for solo workflows — teams want every member to have agent-write powers.
  • Custom caps. Anything beyond Builder’s 100 blocks / 5 schedules / etc.
  • Non-Stripe billing. PO, ACH, annual invoicing with net-30, etc.
Contact us — we flip the plan literal manually and there’s no self-serve path.

Plan changes propagate immediately

On checkout.session.completed (Stripe webhook), the workspace’s plan flips to builder and the limit table jumps the same tick. There’s no cache, no daily reconciliation — the next mutation sees the new caps. Same on cancel and downgrade: the moment Stripe’s webhook lands, the workspace is back on Free’s caps. Existing over-cap resources stay (we don’t delete blocks when you cancel), but new creates get LIMIT_REACHED.

Reading limits programmatically

What’s next

Trial and portal

How the 14-day trial works, how to cancel, what the Customer Portal can do.

Plans and limits (deep dive)

Per-resource caps, programmatic preflight, and how the gates fail.