mailbot-programmable-inbox

# mailbot — Programmable Email for AI Agents

Give your AI agent a real email address in one API call. Send, receive, reply in-thread, track delivery, and replay webhooks — no IMAP, no Gmail, no hacks.

```bash
npx skills add yopiesuryadi/mailbot-programmable-inbox
```

Works with Claude Code, Cursor, Codex, Windsurf, Cursor, Cline, Roo Code, and [40+ more agents](https://github.com/vercel-labs/skills).

---

## What's New

**v0.5.0** — 5 copy-paste examples (support bot, CI test, webhook handler, attachments), webhook event reference with payload docs, `.env.example` for quick setup.

**v0.4.0** — Cloudflare DNS auto-connect: provide an API token, mailbot creates SPF/DKIM/DMARC records automatically (zone auto-detected). Pricing enforcement live — daily send limits, attachment size limits, webhook endpoint limits, data retention per plan. 3-tier abuse scanning with PhishTank, content scoring, and spray detection.

**v0.3.0** — Custom domain management via API (add, verify SPF/DKIM/DMARC, delete). New `/connect` integration guide in dashboard with step-by-step setup for cURL, Node.js, Python, and MCP Server.

**v0.2.0** — Skill published on [Agent Skills](https://agentskills.io) open standard. One-command install for 40+ agents. MCP Server with 12 tools. Node.js and Python SDK.

---

## Why mailbot

Every email API today — SendGrid, SES, Postmark — assumes a human writes the email. They're built for marketing blasts and transactional receipts. AI agents need something different.

| What agents need | SendGrid / SES / Postmark | mailbot |
|---|---|---|
| Dedicated inbox per agent | No — shared sender | Yes — `[email protected]` in one call |
| Reply in same thread | Manual `In-Reply-To` headers | Automatic — just call `reply()` |
| Wait for inbound reply | Poll IMAP or build webhook infra | Built-in `waitFor()` with timeout |
| Replay failed webhooks | Re-trigger from logs manually | One API call, any URL |
| Works without DNS setup | Need domain verification |