1mail.dev
@1mail.dev

MCP · CLI · API · no key

Disposable email.AI-first. Great for humans too.

Give your agent an inbox in one tool call. 1mail.dev is public, inbound-only email it can read over MCP, a CLI or an API, with no signup and no key. The agent creates an address, waits for the verification mail and reads the code. You can watch the same inbox in the browser. Twenty-four hours later, it’s gone.

Public, even when it’s yours. Anyone who knows the address can read it. Never point it, or an agent, at anything sensitive or any account you care about.

wait_for_message ✓
expires in 19h 39m
The 1mail.dev Workbench: an inbox list, an open message with its login code, and the message inspector

01 / What it is

Everything the agent needs. Nothing the account needs.

One inbox, four ways in: MCP for agents, a CLI for scripts, an API for test runners, a viewer for humans. No sandbox, no key, no invoice.

@

Any address is real

Type a name and send. Every syntactically valid local part works immediately; plus-tags and dots stay distinct. Want privacy by obscurity? generate_address and 1mail new create unguessable names (about 60 bits of randomness).

→

Waits, doesn’t poll

wait_for_message matches on sender or subject. wait= holds an API or CLI call for up to 30 s, and each call counts as one read. ETag/304 and since_id keep polling cheap.

←

Inbound only

1mail never sends, replies or forwards. It cannot become an outbound spam vector — or a surprise in your test.

{ }

Machine-readable

OpenAPI 3.1 to generate clients from, llms.txt for agents that read docs, RFC 9457 errors. Messages expire 24 h after arrival, and there is no delete endpoint to race.

02 / The free public tier

The free tier, side by side.

Free public tier comparison: 1mail.dev, Mailinator and Yopmail
Free public tier1mail.dev oursMailinatorYopmail
MCP serverHosted, one URLSelf-run local server · list, getNone published
APIIncluded, no keyPaid / verification-gatedNot documented
Retention24 hours, fixedA few hours8 days
AttachmentsIn raw .emlNot on the free public tierNot documented
PollingLong-poll wait, ETag/304Paid APIRefresh the page
ContractOpenAPI 3.1API docs for subscribersNone published
Price$0$0 for public webmail$0

Free public tiers only, checked October 2026. Sources: Mailinator pricing · Mailinator FAQ · mailinator-cli · Yopmail.

03 / For agents

Hand your agent an inbox.

One URL in your MCP client. No key to paste into a prompt, no SDK to install, no sleep loop to write.

https://api.1mail.dev/mcp

Add it to any MCP client. Setup guides →

Rather a shell? npx 1mail new gives you an address; 1mail list --wait waits for the mail. CLI docs →

generate_address()
→ k7m2xq9vbt4w@1mail.dev

wait_for_message(
  address: "k7m2xq9vbt4w@1mail.dev",
  from: "noreply@github.com",
)
→ holds until the mail lands, then returns it
  fully parsed — subject, text, links, code:

{
  "subject": "[GitHub] Verify your device",
  "text": "Your code is 248913, or open
           https://github.com/verify/4f2a9c"
}