QA track

Playwright email verification

MailAgent gives Playwright tests a disposable inbox API: create an address, fill the signup form, wait for the verification mail, read OTP or magic link — no Mailpit wiring in CI when you use POST …/simulate or hosted API.

Quick start

npm install @mailagent/qa@latest

import { createMailAgentQa } from "@mailagent/qa";

const qa = createMailAgentQa({ apiKey: process.env.MAILAGENT_API_KEY });
const inbox = await qa.createInbox({ service: "github", label: "pw-signup" });
// page.fill('[name=email]', inbox.address)
const v = await qa.waitForVerification(inbox.id, { subjectContains: "verify" });
// v.otp or v.primaryLink

Why MailAgent

• REST + MCP — same flow for Cursor agents and Playwright
• mailagent_simulate_message / scenario=magic_link in CI without SMTP
• Scoped team keys with labelPrefix=ci- for parallel runs

QA docs Console MCP signup QA Python SDK