# MacroMail

> MacroMail is a developer-first email API for sending transactional and
> broadcast email. It is a drop-in replacement for Resend: change one import
> and one base URL to migrate. Send via a typed SDK (@macromail/sdk), REST,
> or an MCP server so AI coding agents can send email with zero glue code.
> All email sends over Amazon SES under the hood. Free tier: 3,000 emails/mo.

## Start here
- [Quickstart: send your first email](https://macromail.dev/docs#quickstart): Six lines from `npm install` to a delivered email.
- [Authentication](https://macromail.dev/docs#auth): API keys (`mm_live_…` / `mm_test_…`), scopes (sending vs full), and the `Authorization: Bearer` header.
- [Migrate from Resend](https://macromail.dev/migrate): One-line import swap; identical method surface.

## SDK
- [TypeScript / Node SDK](https://macromail.dev/docs#sdk): `@macromail/sdk`, `mm.emails.send({...})`, fully typed.
- [Sending email](https://macromail.dev/docs#sending): from, to, subject, html/text, cc, bcc, reply_to, tags, scheduled_at.
- [React email templates](https://macromail.dev/docs#react): Pass a React component as `react:`.

## REST API
- [POST /v1/emails](https://macromail.dev/docs#api): Send a single email.
- [POST /v1/emails/batch](https://macromail.dev/docs#api): Send up to 100 in one call.
- [Domains](https://macromail.dev/docs#api): Create, verify, list, delete sender domains; get DNS records.
- [API keys](https://macromail.dev/docs#api): Create scoped keys.
- [Audiences & contacts](https://macromail.dev/docs#api): Manage broadcast recipient lists.
- [Broadcasts](https://macromail.dev/docs#api): Create and send campaigns to an audience.

## Agents / MCP
- [MCP server](https://macromail.dev/agents#mcp): Tool list, stdio + HTTP transports, install blocks for Claude/Cursor/Windsurf.
- [Use with Claude Code, Cursor, Windsurf](https://macromail.dev/agents#install)

## Operations
- [Domain verification (SPF/DKIM/DMARC)](https://macromail.dev/docs#domains): Exact DNS records and how to check them.
- [Webhooks & events](https://macromail.dev/docs#webhooks): delivered, bounced, complained, opened, clicked.
- [Errors](https://macromail.dev/docs#errors): Every error code, what causes it, and the fix.

## Optional
- [Pricing](https://macromail.dev/pricing): Free (3k/mo), Pro ($20/mo, 50k), Scale (custom).
- [Full machine-readable reference](https://macromail.dev/llms-full.txt): The complete API surface in one file.