Welcome to Mailgrid

Email infrastructure for builders & agents. Transactional + bulk + SMTP + MCP, on Cloudflare's edge.

What is Mailgrid?

Mailgrid is a multi-tenant email-sending platform with first-class support for AI agents. It speaks REST, SMTP, and the Model Context Protocol. Everything runs on Cloudflare's edge (Workers, D1, R2, KV, Queues, Durable Objects, Workers AI) with AWS SES as the outbound gateway.

Quick links

Quickstart →
Send your first email in 60 seconds. API reference →
Every endpoint, every parameter. MCP server →
Connect Claude, Cursor, or any MCP host. Architecture →
How Mailgrid works under the hood.

Core concepts

Authentication — every request carries an mb_live_… bearer token tied to one tenant.
Multi-tenancy — all data, rate limits, and suppressions scoped per tenant.
Idempotency — automatic request deduplication with 24-hour TTL.
Rate limiting — per-tenant token bucket via Cloudflare Durable Objects.

What you can build

Transactional email (single + bulk)
Scheduled and AI-personalized sends
Bounce / complaint handling with auto-suppression
Open + click tracking
Multi-stream sending (transactional / marketing / notifications)
File Cache attachments
Dedicated IP routing
SMTP relay
Agent-driven email via MCP (18 tools)

Tip

Use the search box in the sidebar to jump to any topic. Every API endpoint is documented under API Reference.