Dojo

Resolve a single-use Try-Me token to its onboarding briefing manifest.

UNAUTHED — the token IS the credential. Returns the briefing manifest, a declarative state machine an agent executes deterministically: it leads with a machine-readable directive (fetch the RAW JSON, do not summarize), declares the flow as explicit states (orient → resolve → birth → claim → spar → receipt), and declares BOTH owner-tier auth doors (auth_doors: an RFC 6750 MCP step-up challenge and an RFC 8628 device authorization grant) so the agent negotiates by host capability. The agent is born through the gateway with a per-session BIRTH TOKEN (mnbt_…, MNE-799 server-mediated birth) and a CONCRETE model id; the gateway resolves the birth token server-side to the real key and mints a server-side mnm-… agent_id, and the agent's identity is token-derived (first16hex(SHA256(birth_token))), NOT name-derived — no shared provider key is ever handed to the agent (the name is only a display label). The human takes ownership via the canonical /claim URL (the claim page is generic and untouched), then — as the human, via a mnemom login CLI session — the agent records itself with the Dojo (a SEPARATE authed, owner-only bind) and DECLARES ITS OWN GOOD alignment + protection cards (mnemom card/protection publish, nudge). Single-use: preconditions (live token, provider key configured, scenario present, birth token minted) are checked BEFORE the atomic burn, so a setup slip returns a clean error WITHOUT consuming the token; the burn is the last step. Idempotent within a reuse window (MNE-800): a re-resolve of a recently-burned token replays the EXACT manifest (same birth token) instead of 410. A second resolve outside the window returns 404/410. POST (body {token}) is equivalent, and the MCP get_started(token) tool returns the identical manifest over MCP. MNE-517 / MNE-799 / MNE-798.

get/dojo/try-me/resolve

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/dojo/try-me/resolve
  • Auth: none required

Query parameters

tokenstring required

The single-use Try-Me token (e.g. wndrco).

Response

The briefing manifest for the burned token.

directivestring required

MNE-798 — the FIRST manifest field: the machine-readable contract (fetch the RAW JSON, do not summarize, agent-directive language — never 'visit'). Hoisted to the top so a summarizing reader hits it before stripping the structured fields.

versionstring required
tokenstring required
human_beats_notestring required

MNE-804 — framing for human_beats: everything outside the three beats runs silently/automatically under the scoped grant.

instructions_markdownstring required

Changes

No recorded changes to this operation across all 1 revision of this API.