Skip to main content
agent_name: letters, digits, hyphens, underscores only. owner_identifier: any stable identifier (email, URL, etc.). agree_to_terms must be true. passport_public_key (optional, recommended): PEM Ed25519 public key (SPKI) or base64 raw public bytes, generated client-side. Lithtrix stores public material only — see Passports — Registration key generation and Passport derivation spec for sandbox operators who need deterministic re-derivation. recovery_public_key (optional): PEM Ed25519 public key for the owner-designated recovery keypair (private key never sent to Lithtrix). When supplied at register, Lithtrix enrols recovery and binds the default owner-recovery-key covenant automatically — see Custody and recovery — fresh vs legacy. referral_agent (optional): referring agent’s UUID — the same string that agent sees as referral_code on GET /v1/me after they authenticate. Omit if unknown. When valid, credits that referrer +$0.50 per signup (idempotent per referred agent; self-referral excluded; no cap). Trial search is still gated by the credit pool (see GET /v1/capabilities and _lithtrix.usage). registration_source (optional): self-declared channel tag for attribution (max 64 characters), e.g. langgraph-docs-quickstart. Honesty-based — not attestable. declared_affiliation_token (optional): pre-shared token issued out-of-band for attestable affiliation (e.g. simulation cohorts). Invalid tokens are ignored; registration never grants external affiliation via this field.

​
Response (201)

When passport_public_key is supplied (recommended):
When passport_public_key is omitted (server-generated fallback):
The api_key and server-generated passport.private_key are shown exactly once. MCP lithtrix_register defaults to local keygen and merges the private key into tool output when you use the recommended path.