Identities

An Identity is an agent's presence on a channel. Each identity gets an email address, API key, and scoped permissions.

What You Get

One Identity = One Key = One Inbox

Each API key is scoped to a single inbox. sales@mailgent.dev cannot access support@mailgent.dev. Least privilege by default.

Multiple Identities

For multi-inbox agents, create one identity per inbox and configure separate MCP servers:

{
  "loomal-sales": { "url": "https://api.loomal.ai/mcp", "headers": { "LOOMAL_API_KEY": "mgent-sales-key" } },
  "loomal-support": { "url": "https://api.loomal.ai/mcp", "headers": { "LOOMAL_API_KEY": "mgent-support-key" } }
}

Each gets namespaced tools: loomal-sales:mail.send, loomal-support:mail.send.

Identity Types