An API agents call before they waste context.

Hosted API early access · contract published, demand-gated · updated 2026-06-13

The CheapAgent Context API answers one question before an agent loads a document: is converting it to TOON worth it? Every response is a structured verdict — a decision with measurements, never prose. The verdict policy is frozen, versioned, and identical on every surface that emits it.

You can call it locally, today

The full /v1 contract already runs on your machine, where document bodies never leave your machine. No waitlist for any of this:

# MCP server (Claude Code, Cowork, any MCP client)
claude mcp add doc2toon -- npx -y -p doc2toon-registry@npm:doc2toon@0.4.x doc2toon-mcp

# Localhost HTTP — the same /v1 endpoints this page's spec describes
npx -y -p doc2toon-registry@npm:doc2toon@0.4.x doc2toon serve --port 8787
curl -s -X POST http://127.0.0.1:8787/v1/profile \
  -H "content-type: application/json" \
  -d '{"content": "# My agent doc\n\n..."}'

# CLI, same verdict object
npx doc2toon@^0.4 profile --json CLAUDE.md

# CI — comment on PRs when agent docs bloat
# uses: Profusion-AI/doc2toon@action-v1

Tools: profile, convert, validate, and plan — per-section context plans that say which parts of a mixed document independently earn conversion, under the same frozen policy.

The hosted API: same contract, explicit trust boundary

https://api.cheapagent.ai will expose the identical contract for the places local-first can't reach: CI at scale without per-runner installs, fleets of agents that can't ship a Node runtime, batch checks across many repos. Sending a document to the hosted API is an explicit opt-in — it is the one CheapAgent surface where a document body leaves your machine, and it is framed that way on purpose. The hosted posture is drafted and published before launch: no document body storage by default; report history only if you opt in.

We are deliberately not launching hosted until enough people need it. The contract is built and frozen; the spec below is the real one; early-access demand decides the launch. That honesty is cheaper for you than a half-run service.

The contract, published first

• OpenAPI 3.1 spec — POST /v1/profile, /v1/convert, /v1/validate, /v1/plan (implemented in doc2toon serve today); /v1/estimate and /v1/batch are spec-only, marked x-status: planned. Pinned copy of the canonical spec in the doc2toon package (x-source: doc2toon@0.4.2); the running local server serves its own at GET /v1/openapi.yaml.
• Verdict v1 JSON Schema — the same canonical decision object shipped in the npm tarball. This URL is the schema's own $id.

A third party could implement a compatible server from those two files alone. That is the definition of done we held the contract to.

Early access

Clicking either button counts one anonymous interest click on our side (a server-side number — no cookie, no identity, no document), then forwards you on: Pro to secure checkout, Enterprise to the design-partner application — or to the waitlist below while a destination is being set up.

Join the hosted API waitlist

Prefer to just ask?

If you have a concrete need — a team, a fleet, a deadline — skip the form: email us with the subject “Hosted API early access”. Labeled subject lines are how we count direct asks, so keeping the subject helps us take the demand signal seriously.

The posture, restated

In the browser workbench, the CLI, MCP, CI, and doc2toon serve, your documents never leave your machine. The hosted API is the explicit, opt-in exception — and it launches when demand justifies running it properly, not before. CheapAgent does not promise TOON always saves tokens. It tells you when it does. The honesty benchmark is where we publish the losses.