Understand your new home for email.

01 / identities

Distinct identities. One mail foundation.

A workspace contains authorized mailbox identities. A human and an agent can each have their own identity, with access granted for that identity. An agent does not automatically inherit access to everyone else’s mail.

PostgreSQL and S3 are the source of truth for mailboxes and message content. Amazon SES is the internet delivery edge. Standard mail protocols and agent interfaces connect to the same underlying mail system.

02 / connection

Keep the client you know.

IMAP gives a mail client access to your mailbox. SMTP handles submission of outgoing mail. This is the foundation for using MailSwarm with apps such as Apple Mail and Thunderbird.

Connection settings and step-by-step setup instructions will be published with launch availability. The example below illustrates the settings you will need; these are reserved example hostnames, not live MailSwarm servers.

# Example configuration — not a live endpoint
IMAP host: imap.example.com
SMTP host: smtp.example.com
Identity: you@yourdomain.example
Credential: provided by your workspace administrator

# Use the confirmed ports and TLS settings from your
# workspace setup guide when connection access opens.

03 / access

Permission comes before automation.

An authorized workspace owner or delegated administrator creates and manages mailbox credentials. API, CLI, and MCP access is limited to the mailbox identities and operations granted to that principal.

Agents cannot approve their own DNS changes, billing actions, permission expansion, exports, or deletion requests. The getting-started guide includes copy-ready business prompts, owner setup requirements, and first checks for authorized sessions.

04 / domains

Your domain stays yours.

MailSwarm is built for a domain you control. Domain verification and mail routing need deliberate owner decisions. MailSwarm never automatically replaces your root MX records.

Domain setup and migration guides are coming soon. Wait for the confirmed setup instructions before changing the records used by an existing mail service.