Proxy Mail QA

View saved version →

---
name: proxymail-qa
description: Test sign-up, email verification, login-code (OTP), magic-link, password-reset and invite flows with disposable Proxy Mail QA inboxes. Use when a task needs a fresh email address for an app under test and the code or link from the email it receives.
---

# Testing email flows with Proxy Mail QA

Proxy Mail QA gives you disposable email addresses and hands back the verification code or link from each email that arrives, without the rest of the email. It supplies the inbox and the details for a sign-up form; it doesn't create accounts in the app or fill in its forms. You sign up in the app with your own browser or app tools.

## Setup

This plugin adds the Proxy Mail QA MCP server (tools named `create_address`, `wait_for_code`, `wait_for_link`). It signs in through the browser: if the tools aren't available yet, ask the person you're working for to connect Proxy Mail QA, sign in and choose a project. There's no key to set up.

## Test a sign-up

1. Check the project with `get_project`. It gives the project's default mail domain and the others available, the prefix addresses start with, and how long they last. Don't assume a domain: the ones in examples here aren't necessarily this project's.
2. Create an address with `create_address`, with a password if the sign-up form asks for one: `{"label": "Sign-up test", "password": true}`. It also returns a fictional first name, last name and username. The password comes back once, in this result, and is saved on the address so the person can sign in as the test account later. If the form asks for a date of birth, add `"age": "adult"` (or `over21`, `under18`, `under15`, `under13`, `any`, `turns18tomorrow`, `turned18today`): the persona then has `date_of_birth`, YYYY-MM-DD. Write it in the order the form asks for. If it asks where they live, or the test is about a region, add `"country": "GB"` (any ISO 3166-1 alpha-2 code). Add where the account is used: `"site"` (the app's host or the page URL, such as `staging.example.com`) and `"environment"` (such as `staging`, `qa` or `local`). The person sees both on the account in the app, and `list_addresses` finds accounts by them.
3. Fill in the app's form with the address, persona and password, and submit it. For a form with more than an email field (a username with rules, a date of birth, a country drop-down), use `form_values` instead of `create_address`: send what the page says about each field (`id`, `type`, `name`, `label`, `placeholder`, `autocomplete`, `pattern`, `min_length`, `max_length`, and a drop-down's `options`), and it returns the value for each field from a new address made for the form, its password included. You still fill in the form and submit it.
4. Wait for what the email contains:
   - A code: `wait_for_code` with `{"address": "…"}`
   - A link: `wait_for_link` with `{"address": "…"}`, and `kind` `reset` or `magic_signin` for those emails
   Each waits up to 30 seconds and also returns a match from the last 15 minutes.
5. Enter the code, or open the link if the task calls for it. Many forms split a code into one box per digit. Click the first box and type the whole code: most move to the next box on each digit, and many spread a pasted code across them. If a box keeps only one character and focus doesn't move, fill each box with its own digit, in order. Before submitting, check (with a screenshot, or by reading the boxes) that every digit is in place: a partial code counts as a wrong attempt, and many apps lock the account after a few.
6. Record what the account is for with `update_address` and `notes`.

If the app changes the test account's details, keep the saved ones in step so the person can still sign in as it: save a new password with `set_password` (`{"address": "…", "password": "…"}`, or leave `password` out to generate one, returned once), and a new name or username with `update_address` and `first_name`, `last_name` or `username`.

## Check it worked

- The app shows the accoun

Preview of the first 4,000 characters. Read full instructions →