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
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.