mcp__agent-inbox__create_inbox — Create a new temporary inbox. Optional name parameter for easy reference.
mcp__agent-inbox__check_inbox — Check for messages. Returns subjects, bodies, and extracted confirmation links.
mcp__agent-inbox__wait_for_email — Poll until a matching email arrives. Filters by from and subject_contains. Auto-retries with backoff.
mcp__agent-inbox__verify_email — One-shot: polls for confirmation email, extracts link, visits it via HTTP GET. Three steps in one call.
mcp__agent-inbox__list_inboxes — List all active inboxes in this session.
mcp__agent-inbox__delete_inbox — Delete an inbox when done.
Fast path (recommended) — use verify_email for the common case:
- Create inbox —
create_inbox({ prefix: "signup", name: "test" })
- Use the address — Enter it in a sign-up form, invite field, etc.
- Verify in one call —
verify_email({ address: "test", subject_contains: "confirm" }) — polls for the email, extracts the link, visits it via HTTP.
- Clean up —
delete_inbox({ address: "test" })
Manual path — when you need more control:
- Create inbox —
create_inbox({ prefix: "signup", name: "test" })
- Use the address — Enter it wherever the service asks for an email.
- Wait for email —
wait_for_email({ address: "test", from: "noreply@example.com", timeout_seconds: 60 }) — polls with backoff until a matching email arrives.
- Act on links — Navigate to the confirmation link via browser automation or HTTP.
- Clean up —
delete_inbox({ address: "test" })
1. create_inbox(prefix: "auth-test", name: "signup")
→ auth-test-1234567890@somedomain.com (name: signup)
2. Fill sign-up form with that address + a password
3. verify_email(address: "signup", subject_contains: "confirm")
→ Email verified successfully!
HTTP Status: 200
Final URL: https://myapp.com/welcome
4. delete_inbox(address: "signup")
1---2name: agent-inbox3description: Create temporary email inboxes and receive emails for testing auth flows, email verification, account confirmation, and any scenario where an AI agent needs to receive an email. Uses the agent-inbox MCP server with mail.tm + 1secmail fallback.4---56<objective>7Create temporary email inboxes on demand, receive real emails from any service (Supabase, Resend, SendGrid, etc.), extract confirmation/verification links, and optionally verify them in one tool call.8</objective>910<when_to_use>11- Testing sign-up / auth flows that require email verification12- Receiving "confirm your account" or "verify your email" links13- Any automated workflow where you need to receive an email14- E2E testing of email-sending features15</when_to_use>1617<tools>18Six MCP tools from the `agent-inbox` server:1920- `mcp__agent-inbox__create_inbox` — Create a new temporary inbox. Optional `name` parameter for easy reference.21- `mcp__agent-inbox__check_inbox` — Check for messages. Returns subjects, bodies, and extracted confirmation links.22- `mcp__agent-inbox__wait_for_email` — Poll until a matching email arrives. Filters by `from` and `subject_contains`. Auto-retries with backoff.23- `mcp__agent-inbox__verify_email` — One-shot: polls for confirmation email, extracts link, visits it via HTTP GET. Three steps in one call.24- `mcp__agent-inbox__list_inboxes` — List all active inboxes in this session.25- `mcp__agent-inbox__delete_inbox` — Delete an inbox when done.26</tools>2728<process>2930**Fast path (recommended) — use `verify_email` for the common case:**31321. **Create inbox** — `create_inbox({ prefix: "signup", name: "test" })`332. **Use the address** — Enter it in a sign-up form, invite field, etc.343. **Verify in one call** — `verify_email({ address: "test", subject_contains: "confirm" })` — polls for the email, extracts the link, visits it via HTTP.354. **Clean up** — `delete_inbox({ address: "test" })`3637**Manual path — when you need more control:**38391. **Create inbox** — `create_inbox({ prefix: "signup", name: "test" })`402. **Use the address** — Enter it wherever the service asks for an email.413. **Wait for email** — `wait_for_email({ address: "test", from: "noreply@example.com", timeout_seconds: 60 })` — polls with backoff until a matching email arrives.424. **Act on links** — Navigate to the confirmation link via browser automation or HTTP.435. **Clean up** — `delete_inbox({ address: "test" })`4445</process>4647<important_notes>48- Named inboxes: pass `name` to `create_inbox`, then use that name in all other tools instead of the full email address.49- Fallback providers: mail.tm is primary, 1secmail kicks in automatically if mail.tm is down.50- Inboxes are cleaned up automatically when the MCP server shuts down.51- Some services block disposable email domains. If sign-up is rejected, the service may have these domains on a blocklist.52</important_notes>5354<example>55**Testing a Supabase auth sign-up flow (fast path):**5657```581. create_inbox(prefix: "auth-test", name: "signup")59 → auth-test-1234567890@somedomain.com (name: signup)60612. Fill sign-up form with that address + a password62633. verify_email(address: "signup", subject_contains: "confirm")64 → Email verified successfully!65 HTTP Status: 20066 Final URL: https://myapp.com/welcome67684. delete_inbox(address: "signup")69```70</example>