MCP server
Claude Code
claude mcp add mailagent -e MAILAGENT_API_KEY=ma_… -- npx -y -p @mailagent/mcp@latest mailagent-mcp
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
Submit your form
› page.fill("#email", address)
› page.click("text=Create account")
✓ email received in 2.9s
Get primaryAction
"agent": { "primaryAction": {
"type": "otp",
"value": "482901",
"instruction": "Enter this code in the
verification field on the signup site."
} }
✓ verified, inbox deleted
Integrations
Set MAILAGENT_API_KEY, then install for your client.
MCP server
claude mcp add mailagent -e MAILAGENT_API_KEY=ma_… -- npx -y -p @mailagent/mcp@latest mailagent-mcp
Plugin
codex plugin marketplace add navorina-labs/MailAgentcodex plugin add mailagent@mailagent
MCP config
In .cursor/mcp.json: npx -y -p @mailagent/mcp@latest mailagent-mcp
Skill: npx skills add navorina-labs/MailAgent --skill mailagent
GitHub Actions
Store MAILAGENT_API_KEY as a secret. Use one inbox label per job.
How it works
mailagent_create_inbox returns a unique address for the run.
The agent enters the address in your signup, login, reset or invite form.
mailagent_verify_signup waits for the email and returns agent.primaryAction.
Response
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" } } }
Comparison
Type, value and instruction in one field.
Received subjects, match count, debug URL.
stdio and remote, Codex plugin, agent skill.
Inject a test email with one API call.
| Feature | Mail Agent | Mailpit, MailHog | Mailosaur, MailSlurp, Mailtrap |
|---|---|---|---|
| Next action for the agent | primaryAction | No | Code and link extraction |
| Timeout diagnostics | Yes, with debug URL | No | Timeout error |
| MCP server | Yes | No | Varies by vendor |
| Test without SMTP | simulate | Needs SMTP | Needs SMTP |
| Staging and production senders | Yes | Local only | Yes |
| Starting price | Free, or self-host | Free, self-hosted | Paid, free tiers vary |
Pricing
Limits are per account. Emails count inbound and outbound, the counter resets monthly.
500 emails/month. All API, MCP and SDK features.
5000 emails/month. Same features, cancel any time.
Same API and MCP tools. Self-host guide
Pilot
Pro limits during the pilot and help with the first flow.
Or email hello@webmailagent.com
Usage policy
Use Mail Agent only for apps you own or are authorized to test.
Keys are revoked.
Disable CAPTCHA in your staging.
Inboxes expire after the run.
Inbound testing only.
FAQ
No. Your app sends email as usual to the Mail Agent address.
The timeout response lists received subjects, the match count, a suggested subjectContains and a debug URL. Troubleshooting
Yes. POST /v1/inboxes/:id/simulate injects a test email without SMTP.
Yes. See custom domain and self-host.
$29 per month through Stripe, on the same API key. Cancel or change the card in the billing portal.
$29 per month. Card payments are being set up, until then Pro is enabled on request.
Free plan with 10 inboxes. Pilot teams get Pro limits.