Agent signup
With the person's permission, POST their email to https://ink.ego.ist/api/agent/signup. This public JSON endpoint needs no API key or cookies.
{"email":"person@example.com","plan":"ink","interval":"monthly","agent":{"name":"Example agent","url":"https://example.com","version":"1.0"}}
Only email is required. plan is ink or ink_pro (default ink); interval is monthly or annual (default monthly). When agent is supplied, name is required; its HTTPS URL and version are optional. Email is trimmed and lowercased. Validation uses syntax and a local list of temporary domains, without network lookups. Unknown fields are rejected. The request body allows 4,096 bytes.
Hand off to the person
HTTP 201 returns claim_code, claim_url, expires_at and next_steps. Show the link and eight-character code to the person. No email is sent. Existing and new emails receive the same response shape; never infer account existence.
The person opens the link or the claim page, signs in or signs up through ego.ist with the supplied email, accepts Ink terms and continues to Stripe Checkout. Card entry always needs the person. Claims expire after 24 hours and allow 5 failed attempts.
The code grants no account access, assistant authorization or Passport memory permission. No tokens are issued by signup. WorkOS identity_assertion, service_auth, anonymous registration, assertion exchange and claim polling are not supported. MCP authorization is a separate consent step.
Plans and trial
| Plan | Monthly USD | Annual USD | Words per month |
|---|---|---|---|
| Ink | 19 | 190 | 50,000 |
| Ink Pro | 39 | 390 | 200,000 |
Eligible accounts receive one 7-day Stripe trial, card upfront, capped at 10,000 input words. It converts to the chosen paid plan unless cancelled. Returning customers start paid subscriptions. REST API keys require a paid subscription after trial, except for Unlimited accounts.
Limits and errors
Signup allows 20 requests per IP per hour and 3 per email per hour. Claim confirmation allows 60 per IP per hour and 20 per signed-in user per hour. Do not retry signup in a loop. Wait for Retry-After on HTTP 429.
Signup errors use {"error":"message"}. Invalid requests return 400, oversized bodies 413, unsupported content types 415 and unavailable signup 503. See the signup endpoint reference.