Skip to main content
There are two kinds of free work on the ZeroClick surface. They are enforced in different places — don’t conflate them.

1. Free identity-scoped routes

search/*, orgs/{jobId}, and report. Free forever, code-controlled. guardIdentity verifies the signature + requires a registered agent, makes no allowance call, and attaches no zc-usage (free means free — nothing to settle). These never touch a buyer’s allowance.

2. Included free units on the paid meters

The orgs_index and events_pull meters carry ZeroClick-owned includedUnits, and reach the backend through the normal guard path exactly like paid traffic:
  • The buyer opts into free per call with zc-mode: free at the pay URL. ZeroClick consumes that header and never forwards it — the backend cannot tell a free-mode call from a paid one. The allowance check simply answers allowed, drawing down the buyer’s included units instead of charging.
  • Included units are per buyer (zc-buyer-id), aggregated across every agent that human has claimed (including deleted agents). For pay-as-you-go they do not reset on a schedule — effectively a one-time lifetime free allowance per buyer (“free once, then never again”).
  • Free units require a claimed agent with a verified email; ZeroClick enforces that gate at the pay URL, not the backend.
Because free-vs-paid is invisible to the backend, an app-side “count only the free ones” cap is not possible and intentionally not attempted. The lifetime-per-buyer free allowance is owned entirely by ZeroClick via includedUnits.

Credit parity with the MCP surface

Momentra’s MCP path uses prepaid credits; the ZeroClick path uses ZC units. The two now run on one shared unit with no exchange rate: 1 event = 1 credit = 1 ZC unit = $0.01. You pay per event returned; indexing is free. The two are 1:1 — events_pull meters at one ZC unit per event returned (quantity = the event count), the same as the MCP fetch charge of one credit per event. Indexing (orgs_index) is free and must never be metered with a non-zero quantity. A new ZeroClick buyer’s includedUnits total ≈ 100 ZC ($1), the same free envelope as an MCP user’s 100 signup credits. These constants live in functions/zeroclick/pricing.ts.
Dashboard action: price the events_pull meter at $0.01/unit and set `includedUnits` so each buyer's free total is ~100 ZC ($1). Leave orgs_index unpriced (free). This is the “free once per buyer, never resets” trial.