For Humans

Set up a project by hand in the Console: open the browser, click through the create-project flow, copy the API key, paste it into your code.

Want an agent to sign itself up instead? See For Agents.

Sign in

Go to console.mailgent.dev/login and pick Google or GitHub. First sign-in creates your User + Org automatically — no separate signup form.

Create a project

Click Create Project. You'll fill in:

• Project name — optional. Leave blank for an auto-generated slug like bright-quiet-otter; editable later.

The project bundles mail, vault, calendar, DID, and a USDC wallet on Base. Click Create.

Copy your API key

The mgnt-… API key shows once. Copy it now — it's hashed at rest and can't be retrieved later (only rotated).

export MAILGENT_API_KEY=mgnt-...

That's the key for everything your Identity does: mail, vault, calendar, payments. Works with the REST API, @mailgent/sdk, @mailgent/cli, and the Mailgent MCP server.

What you have now

• Email inbox at <slug>-<5char>@mailgent.dev — send and receive via /v0/messages.
• Encrypted vault for API keys, OAuth tokens, cards, TOTP — see /v0/vault.
• Calendar — events + optional public iCal URL.
• DID identity — Ed25519 keypair for signing, resolvable at did:web:mailgent.dev:identities:<id>.
• USDC wallet on Base — pay paid APIs via payments.pay() under per-call + daily caps.

Need more than one Identity?

Multiple Identities under one Org is common — a sales agent, a support agent, a research agent, each with its own inbox + vault. From the Console dashboard, hit Create Project again. Each Identity gets its own mgnt-….

To do this programmatically, create a platform key (mgpk-…) from your Org settings and call POST /v0/platform/identities. Same key tier the agent flow uses.

Next

• Pay for tools — the paid-call walkthrough (first paid call, mandates, activity).
• Mail, Vault, Calendar — per-capability references.
• MCP setup — plug your Identity into Cursor / Claude Code / a custom agent.