Claim an account

Anonymous sessions are the fastest way in: one HTTP call (or one MCP connection) mints a sandbox project with no signup. Claiming binds that session to a real mailnix account so the work survives and the account's resources become reachable.

Why claim

The flow from an AI session

1. The agent calls account_status to learn which kind of session it has. If it already shows status=claimed, stop: the session was approved by a signed-in browser and is already bound.
2. The agent calls account_claim(email) with your account email.
3. mailnix emails you a magic link. Click it while signed in to app.mailnix.ch.
4. The agent polls account_status until claim_progress.claimed flips to true, typically well under a minute. Same project, same history, now attached to your account.

If you are signed in to the dashboard, pending claims for your email also appear on the Integrations page with a one-click Attach button, so you do not need to open your inbox.

The flow from the consent page

When your MCP client opens the mailnix consent page and you are already signed in, choose Approve as your account and the session starts account-bound. No claim step needed; account_claim is a no-op on such sessions.

After claiming

The session keeps its project binding. Everything the agent created before the claim (traces, sandbox messages, forms) stays reachable, and the account's other resources become listable through the same tools.