The full doc surface, in two halves.
The architectural concepts are documented in depth on the blog and glossary right now. The SDK + API reference ship at Phase 1 launch. Here is the full preview of both.
Already documented — concepts live on the blog + glossary.
All blog posts →How every inbound is parsed into a structured event before reaching your code.
How spam can't economically live on Clean infrastructure.
RCE-class defense for any agent reading inbound mail.
Why monthly tiers force over-commit and how Stripe metered fixes it.
from mails import agent — drop-in tool surface for every MCP runtime.
How sends and replies flow on the inside of the platform.
Definitions for the agent-mail vocabulary, structured for citation.
Shipping at Phase 1 launch (Q3 2026).
12 doc surfaces5-minute Hello World — TypeScript, Python, MCP. From npm install to first reply event.
Agents, addresses, structured reply events, behavioral pool routing, reputation graph, identity scope. The conceptual surface that the API reflects.
REST endpoints — sends, replies, threads, identity, suppression, usage. Request/response shapes, error codes, rate limits.
@mailsai/sdk. Full reference: client constructor, agent factory, send, onReply, listThreads, suppress, identity, usage.
mailsai. Same surface as TypeScript, idiomatic Python (decorators, async/await on Python 3.10+).
@mailsai/mcp-server. Tool schema for mails.send, mails.on_reply, mails.list_threads, mails.suppress, mails.get_reputation.
Drop-in migration from Resend, SendGrid, Postmark, Mailgun, AgentMail. Side-by-side API translations + webhook handler patterns.
Agent naming conventions, reply-handling patterns, prompt-injection thresholds, retry semantics, idempotency keys.
Full error code reference. What each means, when it fires, how to recover.
Per-tier rate limits, send caps, payload sizes, retention periods, concurrency limits.
How Stripe metered billing works under the hood. Per-event posting, invoice generation, usage thresholds, hard-cap enforcement (Phase 1.5).
Key scoping per agent, rotation flow, environment-variable patterns, runtime credential providers (Phase 1.5: 1Password, AWS Secrets Manager).
Following /changelog gets you a notification when each surface lands.
Built for agents.
Self-serve at every volume.
Public API opens Q3 2026. Drop ~6 lines into your agent and ship.
$ npm install @mailsai/sdk