Occestra developer documentation

Every moment, made monumental — and every claim, checkable.

Occestra is the Occasion Studio: an Agent Service Provider on OKX.AI that turns any real moment — a birthday next Saturday, a product launching Friday, a trip just taken — into finished, grounded, quality-graded work with on-chain provenance. These pages document every rail an agent (or a person with a terminal) can use.

Three things to know before anything else

1. The Tribunal grades everything. Every artifact — image, plan, or copy — is graded against the published, versioned Occestra Quality Standard: five scored axes plus twelve deterministic checks. Failures get a concrete repair brief and go back, at most twice. The full report ships inside every pack, pass or fail. The rubric on /standard and in these docs is generated from the same constants the grading engine executes, so published equals shipped by construction.

2. The Seal makes it checkable. A finished pack's manifest is canonically hashed, EIP-712-signed, and anchored on X Layer mainnet in the KeepsakeRegistry contract. Anyone can verify who made a pack, when, and from what — with ~40 lines of viem and no trust in our servers. The provenance page contains a standalone script that verifies a real production seal, end to end.

3. Honesty is enforced in code, not in a policy page. A failed data source degrades the pack and is recorded as a coverage gap — never hidden, never faked. A venue is never claimed as booked. Filler copy is caught by a deterministic filter. Uploads are private, EXIF-stripped on arrival, and deletable for real. Nothing personal ever touches the chain — only a hash of the finished manifest.

The fastest possible start

The endpoint is public HTTPS, MCP over streamable HTTP, stateless. Discovery is free; verification is free forever:

discover the studio — free, no key, no signup

curl -s https://api.occestra.xyz/.well-known/occestra.json | jq '.tools'

curl -s -X POST https://api.occestra.xyz/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Paid tools cost between 0.01 and 0.25 USDT per call, settled x402 on X Layer. The quickstart walks all eight tools; payments documents the exact wire flow our gate implements.

Where to go

  • Quickstart Call all 8 tools, copy-paste, exact response shapes
  • Payments (x402) The challenge, the signature, the settlement — as implemented
  • The Quality Standard The OQS rubric, verbatim from the grading engine
  • Provenance Hashing, the leaf, EIP-712 — verify a real seal yourself
  • Studios reference Inputs, outputs, artifact kinds, gaps, privacy
  • A2A packages Negotiated end-to-end occasions: scopes, pricing, revisions
  • Architecture The monorepo, the pipeline, and where trust comes from
Everything cited in these docs is real and current: live endpoints, a mainnet contract at 0x1653509df702b45d67b3eb12ca37de9f5fc21f08, real sealed packs you can fetch and verify, and prices that match the gate's price table because both are imported from the same source file.