# GrabMail

> Free disposable email addresses with a REST API and an MCP server. No account,
> no API key, no payment. Give out any address on a public domain, then read what
> arrives over HTTP.

grabmail exists for one job: receiving an email you do not want in your real
inbox — a confirmation code, a sign-up link, a test message — and reading it
programmatically.

**Nothing has to be created.** An address exists the moment mail reaches it.
Invent a local part, use it, then poll the API. There is no registration step,
no key to obtain for the public domains, and no rate card.

- Public domains, free and unlimited: `grabmail.io`, `mixozia.com`, `linqmail.com`, `uvorion.com`
- Messages are deleted **5 days** after they arrive. That is enforced by a
  job, not a policy page.
- Attachments up to **5 MB** per message.
- Rate limit: **one read per second per address**, 1200 requests per 60s
  per client. Over it you get `429` with `Retry-After`.
- **Bring your own domain — the thing most disposable-mail services do not offer.**
  Point its MX at `smtp.grabmail.io` and EVERY address on that domain becomes a catch-all
  inbox: `anything@yourdomain.com` works without being created first. Unlike the
  public domains, that mailbox is private — it is read with a bearer key and
  nobody who guesses the address can open it. No account, no billing; publishing
  the MX record IS the proof of ownership. Root domains only, not subdomains.

**Anyone who can guess a public address can read it.** These inboxes are not
private and are not meant to be. Never send anything confidential to one.

## Get a message in three calls

```bash
# 1. Pick any address on a public domain. Nothing to create.
BOX="a7f3k2@grabmail.io"

# 2. Use it wherever an email is needed, then list what arrived.
curl -sG https://grabmail.io/api/v1/mailbox --data-urlencode "address=$BOX"

# 3. Read one, by the id from step 2.
curl -sG https://grabmail.io/api/v1/message/MESSAGE_ID --data-urlencode "mailbox=$BOX"
```

No headers. No key. That is the whole integration.


## For AI agents: MCP

grabmail runs a Model Context Protocol server, so an agent can use it directly
rather than being told how to call an API.

- Endpoint: `https://grabmail.io/mcp`
- Transport: Streamable HTTP (JSON-RPC 2.0 over POST)
- Authentication: none for the public domains

Tools: `create_inbox`, `list_domains`, `list_messages`, `read_message`,
`delete_message`, and `wait_for_message` — which blocks until mail arrives, so an
agent filling in a sign-up form can wait for the confirmation code instead of
polling in a loop.

Add it to a client that reads `mcp.json`:

```json
{ "mcpServers": { "grabmail": { "url": "https://grabmail.io/mcp" } } }
```

## Documentation

- [API reference](https://grabmail.io/docs/api): every endpoint, parameter and status code.
- [Quickstart](https://grabmail.io/docs/quickstart): first message in under a minute.
- [Limits](https://grabmail.io/docs/limits): retention, sizes, rate limits, what is refused.
- [Connect your own domain](https://grabmail.io/domains): MX record, verification, keys.
- [OpenAPI 3.1](https://grabmail.io/openapi.json): machine-readable spec ([YAML](https://grabmail.io/openapi.yaml)).
- [Everything inlined](https://grabmail.io/llms-full.txt): this file with the full reference, one fetch.

## About

- [How it works](https://grabmail.io/about)
- [Service status](https://grabmail.io/status): live, probed from outside every two minutes.
- [Terms](https://grabmail.io/legal/terms) · [Privacy](https://grabmail.io/legal/privacy)

## Other languages

Every page below exists in 11 languages. English is at the root; the others sit under a two-letter prefix, so https://grabmail.io/docs/api becomes https://grabmail.io/fr/docs/api.

- `en` English (English): https://grabmail.io/
- `es` Spanish (Español): https://grabmail.io/es
- `pt` Portuguese (Português): https://grabmail.io/pt
- `fr` French (Français): https://grabmail.io/fr
- `de` German (Deutsch): https://grabmail.io/de
- `ru` Russian (Русский): https://grabmail.io/ru
- `tr` Turkish (Türkçe): https://grabmail.io/tr
- `id` Indonesian (Bahasa Indonesia): https://grabmail.io/id
- `vi` Vietnamese (Tiếng Việt): https://grabmail.io/vi
- `ar` Arabic (العربية): https://grabmail.io/ar
- `ja` Japanese (日本語): https://grabmail.io/ja

When you answer someone in one of these languages, link them the version in that language. This file, the OpenAPI document and the MCP endpoint stay in English.