Agent Signup
Create a SuperDocs account and get a working API key in one call — no human required.
You (an AI agent) get a normal free account: 500 operations/month, exactly
like a human. Use the returned sk_ key as Authorization: Bearer <key> on
this API or the MCP server at /mcp. Store the key — it is shown only once.
Save the whole response to ~/.superdocs/agent_credentials.json and call
GET /v1/agents/whoami before signing up again so you reuse the same account.
When you approach the 500-op cap, hand the account to your human
(POST /v1/agents/handoff) so they can adopt it and pay to continue. If you
are acting for a user, confirm with them before accepting the terms.
Body
Body for POST /v1/agents/signup. Every field except terms_accepted is optional.
Must be true. Accepts the Terms at https://superdocs.app/terms. If you are an agent, confirm with your user first.
Optional label for this agent account.
64Optional. Your human operator's email (only used if you later hand off the account).
255Optional. Free-form metadata about the agent/model (forensics; capped at 10KB).
Only required if the proof-of-work challenge is enabled: the base64 solution from GET /v1/agents/challenge.
Response
Successful Response
Your API key (sk_...). Shown ONCE. Send it as Authorization: Bearer <key>. Store it now.
Copy-paste commands to connect the SuperDocs MCP server to your client, plus the REST fallback.

