Proxy Mail QA
Disposable test inboxes that return sign-up and login codes or links to coding agents
- Pricing
- Freemium
- Platforms
- API, CLI, Chrome extension
- Runs
- Remotely
- Version
- 1.9.0
- Listing updated
- today
Similar MCP servers
About Proxy Mail QA
Proxy Mail QA is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
The README-style docs say coding agents and test suites can create a test address, submit a form with it, and wait for the verification code or link to arrive in one call. Access runs over an MCP server at a remote Streamable HTTP endpoint, or over a REST API with Playwright and Cypress examples.
Sign-in for the MCP server happens in the browser rather than through a pasted key, and the docs also describe a bearer-key option for tools that cannot do browser login. Addresses can be generated with a fictional name, a password, an age or a country when a test needs them, and existing test accounts can be searched by tag, country, age or password presence.
The product is aimed at developers and QA engineers who test sign-up, login and password-reset flows. The docs note that its waits return only the code or link rather than the email body, and that empty results often mean the app's email provider is in sandbox mode and only delivers to verified addresses.
Install
Run in a terminal
claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcpAdd to Settings → Connectors → Add custom connector
https://api.proxymail.qa/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"proxymail-qa": {
"url": "https://api.proxymail.qa/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"proxymail-qa": {
"type": "http",
"url": "https://api.proxymail.qa/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"proxymail-qa": {
"serverUrl": "https://api.proxymail.qa/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proxymail-qa": {
"type": "http",
"url": "https://api.proxymail.qa/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- create_address
- Creates a new email address with a fictional name and username, optionally with a password, age or country.
- list_addresses
- Lists existing test addresses, filterable by tags, country, age, password presence and search text.
- wait_for_code
- Waits up to 30 seconds for a verification code or coupon email to arrive at an address.
- wait_for_link
- Waits up to 30 seconds for an email containing a link to arrive at an address.
What it does
- Single-call code retrieval
- A wait tool blocks for up to 30 seconds and returns the verification code or link as soon as the email arrives.
- Generated test addresses
- New inboxes come with a fictional name and username, and can include a password, age or country.
- Account search
- Existing test addresses can be found again using tags, country, age range, password presence or text search.
- Coupon detection
- A wait with the coupon kind returns an offer code with its discount and end date.
- Browser or key sign-in
- The MCP server signs in through a browser page, with an API key in a header as a fallback.
- Links left unopened
- The service never fetches or follows links, so single-use links remain valid for the test to open.
Good for
- Testing sign-up flows end to end with a verification code from a coding agent
- Automating login and password-reset checks in Playwright or Cypress suites
- Diagnosing why a verification email never arrived when the app uses a sandboxed email provider
- Checking coupon and marketing emails on staging with test payments only
Pricing
Freemium
Free plan includes the MCP server and API; Team plan removes the address limit and raises the request limit.
Prices change. Check proxymail.qa before you buy.
Proxy Mail QA FAQ
Is the API free?
Yes. API keys and the MCP server work on the Free plan, with up to 60 requests a minute per key and 500 addresses in total. The Team plan has no address limit and allows 600 requests a minute.
Does it return the whole email?
Not by default. Waits return the code or link, its kind, the sending service and its expiry. The MCP tools never return email text; the REST API can add plain text with /messages?include=text.
Why does a wait come back empty?
The docs say the app may never have sent the email, or its provider in sandbox or test mode may only deliver to verified addresses. The empty answer states which of these applies.
Can an agent create its own API key?
No. A person creates keys in the app or allows a connector on a sign-in page, so every key belongs to a signed-in account with a confirmed email.
Is Proxy Mail QA free?
Proxy Mail QA has a free plan, with paid plans for more usage or features.
How do I add Proxy Mail QA to Claude Code?
Run this command in your terminal: claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp
What are the best alternatives to Proxy Mail QA?
The closest alternatives to Proxy Mail QA are Test Mailbox, receivemail.dev, smails, Agent Identity MCP and GhosterMail.
Where this comes from
- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.