Docs

Cross-cutting reference for the cipher protocol, wire errors, MCP tool surface, and request flow. For per-product install and quickstart, see Products.

Reference

Protocol reference

• MCP tool surface — the five JSON Schemas registered by the plugin, plus /.well-known/mcp-tools.json.
• Error vocabulary — stable code strings returned on the wire.
• Request flow — the gated-request lifecycle from agent to plaintext.

Product install & quickstart

• For creators

  Cryptolect creator app

• For agent operators

  Agent SDK

• For publishers

  EmDash plugin

How a gated request flows

Agent ───▶ EmDash page (gated)
                 │
                 ▼
    page:fragments hook walks the document body
                 │
       ┌─────────┴────────┐
       │                  │
   no bearer        bearer present
       │                  │
       ▼                  ▼
   403 + JSON       /v1/decode  ──▶  Cryptolect API Worker
   envelope         (per gated         (D1 grants check,
   describing       block)              monthly_used++)
   acquire opts
                            │
                            ▼
                     plaintext rendered
                     into the response

Error vocabulary

Every wire error returns a stable code string. Most useful codes for agents:

• cipher_not_granted — token is valid but lacks a grant for this cipher.
• quota_exceeded — token is valid but the subscription has spent its monthly decode budget.
• invalid_token — token is malformed, revoked, or doesn't exist.
• decode_failed — emojitext could not be decoded against the named cipher.