Mailagent
Temporary inboxes for agent signup QA, create disposable addresses, wait for...
Install
npx skills add hashgraph-online/awesome-codex-plugins --skill mailagent -g -a claude-code -y- Repository
- hashgraph-online/awesome-codex-plugins1.5k
- Category
- Testing
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Temporary inboxes for agent signup QA, create disposable addresses, wait for verification email, extract OTP or magic links. Use when automating signup, login, or email verification without parsing HTML manually.
MailAgent
MailAgent provides programmatic disposable inboxes for AI agents: receive OTP codes and magic links during signup flows, simulate inbound mail in CI, send/reply on verified domains, and diagnose timeouts.
Official docs: https://webmailagent.com/docs/agents.html
When to use
- Signup or login that sends a verification email
- Need OTP or magic link without hand-parsing HTML
- E2E / agent task: "register with a temp email"
- QA without real SMTP (
mailagent_simulate_message) - Not for human privacy burners, programmatic agent inboxes with allowlists
Install (pick one)
Cursor (project)
MCP in .cursor/mcp.json → @mailagent/mcp or mcp/dist/index.js. Skill auto-loads from .cursor/skills/mailagent-mcp/ (synced from this file).
Agent Skills catalog (repo root)
npx skills add Alex0nder/MailAgent --skill mailagent
OpenAI Codex
codex plugin marketplace add Alex0nder/MailAgent
codex plugin add mailagent@mailagent
Guide: https://webmailagent.com/docs/codex.html
npm MCP (any client)
export MAILAGENT_API_URL=https://api.webmailagent.com
export MAILAGENT_API_KEY=ma_…
npx -y -p @mailagent/mcp@0.2.16 mailagent-mcp
Remote (no subprocess): POST https://api.webmailagent.com/mcp + Bearer token.
SDK (without MCP)
| Package | Install |
|---|---|
@mailagent/agent | npm install @mailagent/agent |
@mailagent/qa | npm install @mailagent/qa (Playwright) |
mailagent-agent | pip install mailagent-agent (Python) |
Browser login (no API key in client): Auth0 OIDC on prod, auth.oidc: enabled on GET /v1/agent. Operator setup: npm run wizard:auth0. Docs: https://webmailagent.com/docs/oauth-idp.html
