Email for AI agents

A mailbox your agent can send from and receive to, over a REST API and a native MCP server. Hosted in the EU. An instant mailbox on every plan.

Read the docs View pricing

Send
Receive
One-time codes
MCP
Scoped keys
Your mailbox
Webmail
Errors
EU hosting

Send an email

One POST sends an email. Idempotency-Key is required, so a retried request never sends the same message twice. The call returns 202 with a queued message object.

Send reference

cURL

curl https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/outbound \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["agent@acme.dev"],
    "subject": "Your verification code",
    "body_text": "Reply with APPROVE to continue."
  }'

Receive email

The mailbox stores inbound mail and you read it over REST. Pass live=true to fetch from the source now, with a cached fallback. The response is a list envelope you paginate with next_cursor.

Read inbound

cURL

# Read inbound from cache, or live=true for an on-demand fetch.
curl "https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/messages?direction=inbound&live=true" \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY"

Read a one-time code

Agents often wait on a verification code. Fetch inbound with live=true and read the code the moment it arrives.

cURL

# Blocking on a one-time code? Fetch inbound straight from the source.
curl "https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/messages?direction=inbound&live=true" \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY"

Use it as an MCP tool

Point any MCP client at the endpoint with a mailbox key. The mailbox's actions appear as tools. Transport is streamable-HTTP.

MCP reference

Endpoint

https://mail.sairaph.com/mcp/v1/mcp
Authorization: Bearer $SAIRAPH_MAIL_KEY

Scoped keys

Keys are issued from the dashboard, not over the API, so a leaked key cannot mint or revoke another. Each key carries one role: read, read_write, or management. sm_live_ keys are per-mailbox and work for REST and MCP; sm_mgmt_ keys are tenant-wide.

API keys

Shell

# Keys are issued from the dashboard, not over REST - the issuance surface is
# deliberately not agent-callable, so a leaked key can never mint or revoke
# another. To get one: Dashboard → API keys → pick the mailbox + a role
# (read / read_write / management) + an optional expiry → copy the sm_live_…
# secret (it is shown ONCE). Then set it for your agent and pass it as the
# Bearer token on every REST + MCP call:
export SAIRAPH_MAIL_KEY="sm_live_…"

A mailbox on a Sairaph domain, or bring your own

Every paid plan includes an instant mailbox on a Sairaph domain (sairaph.email, sai.email, or sent.ac), with DKIM handled for you. Bring or buy a custom domain for your own address, or connect an existing Gmail, Google Workspace, or Yahoo mailbox and drive it through the same REST and MCP surface.

How mailboxes work

A webmail inbox for humans

The people on the account get a webmail inbox for the same mailbox: send, read, search, threads, and undo send. No ads.

Errors and rate limits

Errors return a typed envelope you can branch on. Over-limit responses return 429 with Retry-After.

Error reference

JSON

{
  "error": {
    "type": "resource_not_found",
    "code": "mailbox_not_found",
    "message": "No mailbox matches that id.",
    "param": "mailbox_id"
  }
}

EU hosting

Mailboxes and processing are hosted in the EU: OVHcloud storage and an Amazon SES relay in eu-west-1 (Dublin). Message bodies and mailbox credentials are encrypted at rest with a per-customer Fernet key, and credentials are never returned by any API or written to logs. Email is store-and-forward: once a message is delivered it travels to the recipient's server, wherever that is.

Security and trust

Start

An instant mailbox on every plan. Provision a mailbox, get a key, send your first email.

Get started Read the docs

EU data residencyPer-customer encryptionNative MCP

Email for AI agents

Jump to a capability

What every mailbox can do

Send an email

Receive email

Read a one-time code

Use it as an MCP tool

Scoped keys

A mailbox on a Sairaph domain, or bring your own

A webmail inbox for humans

Errors and rate limits

EU hosting

Start