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:

{
  "mailgent-sales": { "url": "https://api.mailgent.dev/mcp", "headers": { "Authorization": "Bearer mgent-sales-key" } },
  "mailgent-support": { "url": "https://api.mailgent.dev/mcp", "headers": { "Authorization": "Bearer mgent-support-key" } }
}

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

Identity Types