# Proxy Mail QA

> Proxy Mail QA is a freemium MCP server for developer tools. Disposable test inboxes that return sign-up and login codes or links to coding agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Chrome extension, Web
- **Website:** https://proxymail.qa/docs/api
- **MCP Registry name:** qa.proxymail/proxymail-qa
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.proxymail.qa/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "proxymail-qa": {
      "url": "https://api.proxymail.qa/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "proxymail-qa": {
      "serverUrl": "https://api.proxymail.qa/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Test Mailbox](https://ai-powered.com/mcp/test-mailbox): Test Mailbox is an MCP server for developer tools.
- [receivemail.dev](https://ai-powered.com/mcp/receivemail-dev): receivemail.dev is a freemium MCP server for developer tools.
- [smails](https://ai-powered.com/mcp/smails): smails is a free MCP server for communication.
- [Agent Identity MCP](https://ai-powered.com/mcp/agent-identity-mcp): Agent Identity MCP is a freemium MCP server for developer tools.
- [GhosterMail](https://ai-powered.com/mcp/ghostermail): GhosterMail is a freemium MCP server for communication.
- [pingutil email verification](https://ai-powered.com/mcp/pingutil-email-verification): pingutil email verification is a freemium MCP server for developer tools.
- [Poofbox Mail](https://ai-powered.com/mcp/poofbox-mail): Poofbox Mail is a paid MCP server for communication.
- [MailBots](https://ai-powered.com/mcp/mailbots): MailBots is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/proxy-mail-qa
