For Humans
Sign in at console.loomal.ai, create a project, copy the API key. The standard flow for developers setting up Loomal manually.
Set up an Identity by hand in the Console: open the browser, click through the create-project flow, copy the API key, paste it into your code.
This page covers the Identity (agent-consumes-paid-APIs) flow. Want an agent to sign itself up? See For Agents. Building a paid endpoint instead? See For Sellers.
Sign in
Go to console.loomal.ai/login and pick Google or GitHub. First sign-in creates your User + Org automatically — no separate signup form.
Create an Identity project
Click Create Project and pick Equip an agent (the Identity option). You'll fill in:
- Project name — optional. Leave blank for an auto-generated slug like
bright-quiet-otter; editable later. - Project type — pick Equip an agent for the Identity bundle (mail, vault, calendar, DID, USDC wallet). The other option, Sell to agents, is for the For Sellers flow.
Click Create.
Copy your API key
The loid-… API key shows once. Copy it now — it's hashed at rest and can't be retrieved later (only rotated).
export LOOMAL_API_KEY=loid-...That's the key for everything your Identity does: mail, vault, calendar, payments. Works with the REST API, @loomal/sdk, @loomal/cli, and the Loomal 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 loid-….
To do this programmatically, create a platform key (lopk-…) from your Org settings and call POST /v0/platform/identities. Same key tier the agent flow uses.
Next
- Pay for tools — Identity flow walkthrough (first paid call, mandates, activity).
- Mail, Vault, Calendar — per-capability references.
- MCP setup — plug your Identity into Cursor / Claude Code / a custom agent.