For AI agents and E2E tests MCP, REST, npm

Email for the AI agents that test your product

Temporary inboxes for signup, login, password reset and invite tests. The API waits for the email and returns the OTP or link as agent.primaryAction.

Free plan: 10 inboxes, 60 requests per minute

Create an inbox

› mailagent_create_inbox({
    service: "auth0", label: "pr-482"
  })

✓ pr-482-k7f2@inbox.webmailagent.com
Free planMIT licenseAPI reference ↗
SignupLoginPassword resetInvites2FA codes

Works with your agent and test runner

Set MAILAGENT_API_KEY, then install for your client.

MCP

MCP server

Claude Code

claude mcp add mailagent -e MAILAGENT_API_KEY=ma_… -- npx -y -p @mailagent/mcp@latest mailagent-mcp

MCP setup →
Plugin

Plugin

Codex

codex plugin marketplace add navorina-labs/MailAgent
codex plugin add mailagent@mailagent

Codex guide →
MCP

MCP config

Cursor and other agents

In .cursor/mcp.json: npx -y -p @mailagent/mcp@latest mailagent-mcp
Skill: npx skills add navorina-labs/MailAgent --skill mailagent

Agent Skills →
npm

npm

Playwright and Cypress

npm i @mailagent/agent @mailagent/qa
Starters: Playwright, Cypress

QA guide →

Three API calls

01Inbox

Create an inbox

mailagent_create_inbox returns a unique address for the run.

02Your app

Submit your form

The agent enters the address in your signup, login, reset or invite form.

03Result

Get the action

mailagent_verify_signup waits for the email and returns agent.primaryAction.

Structured result for the agent

primaryAction has type, value and instruction. On timeout, the response lists received subjects, the match count and a debug URL.

await mailagent_verify_signup({
  inboxId,
  flow: "signup",
  deleteAfterSuccess: true
});

// response
{ "status": "verified",
  "agent": { "primaryAction": {
    "type": "otp", "value": "482901" } } }

Mail Agent and other tools

01primaryAction

Next action

Type, value and instruction in one field.

02diagnose

Timeout details

Received subjects, match count, debug URL.

03MCP

MCP server

stdio and remote, Codex plugin, agent skill.

04simulate

No SMTP in CI

Inject a test email with one API call.

Mail Agent compared with Mailpit, MailHog, Mailosaur, MailSlurp and Mailtrap
FeatureMail AgentMailpit, MailHogMailosaur, MailSlurp, Mailtrap
Next action for the agentprimaryActionNoCode and link extraction
Timeout diagnosticsYes, with debug URLNoTimeout error
MCP serverYesNoVaries by vendor
Test without SMTPsimulateNeeds SMTPNeeds SMTP
Staging and production sendersYesLocal onlyYes
Starting priceFree, or self-hostFree, self-hostedPaid, free tiers vary

Plans

Limits are per account. Emails count inbound and outbound, the counter resets monthly.

$0Free

10 inboxes, 60 req/min

500 emails/month. All API, MCP and SDK features.

$29Pro, monthly

100 inboxes, 300 req/min

5000 emails/month. Same features, cancel any time.

MITSelf-host

Your Cloudflare account

Same API and MCP tools. Self-host guide

Become a pilot

Pro limits during the pilot and help with the first flow.

Or email hello@webmailagent.com

Flows to test

Not supported

Use Mail Agent only for apps you own or are authorized to test.

✕Policy

Bulk signups on third-party sites

Keys are revoked.

✕Policy

CAPTCHA bypass

Disable CAPTCHA in your staging.

✕Policy

Personal email

Inboxes expire after the run.

✕Policy

Bulk outbound email

Inbound testing only.

FAQ

Does my app need changes?

No. Your app sends email as usual to the Mail Agent address.

What if the email does not arrive?

The timeout response lists received subjects, the match count, a suggested subjectContains and a debug URL. Troubleshooting

Can I test without sending real email?

Yes. POST /v1/inboxes/:id/simulate injects a test email without SMTP.

Can I use my own domain or self-host?

Yes. See custom domain and self-host.

How is Pro billed?

$29 per month. Card payments are being set up, until then Pro is enabled on request.

Get an API key

Free plan with 10 inboxes. Pilot teams get Pro limits.