# Dev-Mail

> Dev-Mail (dev-mail.com) gives you a disposable email address for receiving
> verification codes and test mail. It is free, needs no account, and exposes an
> open HTTP API and an MCP server so that scripts and AI agents can use it directly.

Last updated: 2026-09-14

## Facts

- Price: free. There is no paid tier, no trial, and no credit card.
- Account: none. No signup, no login, no email address required to start.
- API key: none. The API is open; a token is issued anonymously per inbox.
- Direction: receive only. Dev-Mail cannot send email.
- Receiving domains (7): diyapn.com, winmail.cfd, mailcom.top, i-os.top, kingshould.com, nicepl.com, aeria-mall.com
- Address lifetime: 6 hours of inactivity. Reading the inbox resets the clock,
  so an address stays alive as long as it is being polled.
- Privacy: messages are readable only with the token that created the address.
  Inboxes are not public and not browsable by address.
- Languages: English and Simplified Chinese.
- Good for: signup and verification-code flows, testing your own product's
  transactional email, keeping marketing mail out of a real inbox.
- Not for: anything you need to keep. Mail is disposable by design.

## Use it from code

- [API docs](https://dev-mail.com/docs/api): full REST reference with curl examples.
- [OpenAPI spec](https://dev-mail.com/openapi.json): machine-readable schema.
- MCP endpoint: https://dev-mail.com/mcp (Streamable HTTP, no auth, stateless).
  Tools: list_domains, create_inbox, list_messages, get_verification_code.

Three-line quickstart:

    ADDR=$(curl -sX POST https://dev-mail.com/v1/inboxes)
    # -> {"address":"...","token":"...","expires_at":"...","ttl_seconds":21600}
    curl -s -H "Authorization: Bearer $TOKEN" "https://dev-mail.com/v1/inboxes/$ADDRESS/code?wait=60"

The code endpoint long-polls for up to 60 seconds and returns the one-time code
already extracted from the message, so you do not have to parse the body yourself.

## Limits

- 60 requests per minute per IP.
- 20 new inboxes per hour per IP.
- Exceeding either returns HTTP 429 with a Retry-After header.

## Pages

- [Home](https://dev-mail.com/v2): what it is, how it works, FAQ.
- [Home, Chinese](https://dev-mail.com/v2/zh)
- [Privacy](https://dev-mail.com/privacy): what is stored and for how long.
- [Terms](https://dev-mail.com/terms)