receivemail.dev

dev.receivemailPublished by receivemail.devOfficial publisherv1.0.1Updated Nov 3, 2026

Disposable email inboxes for agents and tests: create an address, wait for the email. No signup.

VerifiedStreamable HTTPWeb executable

Overview

receivemail.dev's hosted MCP server (receivemail.dev), published by receivemail.dev; no sign-in required; Streamable HTTP; 3 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
receivemail.dev
Endpoint
receivemail.dev
Last checked

Installation

In SourceWeft

  1. Open receivemail.dev in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.receivemail%2Freceivemail/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "receivemail-dev": {
      "type": "http",
      "url": "https://receivemail.dev/mcp"
    }
  }
}

README

receivemail.dev

A disposable, real-receiving email address via one API call. No signup, no SMTP setup, no account. Built for testing verification/OTP emails, signup flows, and anywhere a QA suite would otherwise need to burn a real inbox.

Live at receivemail.dev.

[mcptry]

How it works

bash
# create a mailbox (default: expires in 15 min)curl -X POST https://receivemail.dev/mailboxes# => {"address":"[email protected]","expiresAt":"...","secret":"..."}
# trigger your own app's email to that address, then poll:curl https://receivemail.dev/mailboxes/[email protected]/messages \  -H "Authorization: Bearer <secret from above>"# => {"address":"...","messages":[{"from_address":"...","subject":"...","body_text":"..."}]}

The secret returned at creation is the only credential — hold onto it, there's no account/login. Any address at @receivemail.dev accepts mail even if never explicitly reserved (same as any disposable-inbox provider), but only a reserved address has a secret to read it back with.

Endpoints

EndpointDescription
POST /mailboxesCreate a new address. Optional {"ttlMinutes": 1-60} body, default 15. Public, no token required.
GET /mailboxes/:addressMetadata (created/expiry). Requires the mailbox's own secret as a Bearer token.
GET /mailboxes/:address/messagesLast 50 messages, newest first. Same secret.
GET /mailboxes/:address/wait?timeout=25&since=<ISO>Long-poll: returns the newest message newer than since as soon as one arrives, or {"timed_out":true} after timeout seconds (max 25). Same secret.

Limits

  • 20 mailbox creations/minute per IP, 5,000/day globally.
  • 60 minutes max mailbox lifetime — this is for short-lived test flows, not a permanent inbox.
  • Messages are pruned 24h after their mailbox expires.

Free to use, no API key needed to create a mailbox.

Architecture

Fully serverless, no shared infrastructure with anything else:

  • Cloudflare Email Routing on the receivemail.dev zone receives the actual mail.
  • Cloudflare Worker (src/index.ts) — an email() handler parses and stores incoming mail via postal-mime; a fetch() handler serves the REST API and the landing page (src/landing.ts); a scheduled() handler runs a daily cleanup of expired mailboxes/old mail/rate-limit buckets.
  • D1 (schema.sql, schema_v2.sql, schema_v3.sql) — emails, mailboxes (with a per-mailbox secret for capability-style read access), rate_limits.

Local development

bash
npm installnpx wrangler dev      # local dev servernpm run deploy        # wrangler deploy

Requires a Cloudflare account with the receivemail.dev zone, Email Routing configured, and a D1 database bound as DB in wrangler.toml.

Related

sms-florin — same idea, for SMS/OTP verification codes instead of email (rents a real UK phone number).

Source: README.md at commit b8b2b7d

Tools

3

create_mailbox

Create a disposable mailbox

Create a disposable receivemail.dev email address that receives real mail. Returns address, expiresAt and secret; keep the secret to read the mailbox. Free without a key (up to 60 minutes); with a paid key on the MCP connection, up to 1440 minutes and an extracted otp field on messages.

ParametersttlMinutes

wait_for_email

Wait for the next email

Wait up to 25 seconds for an email to a mailbox made with create_mailbox. Returns {timed_out:false, message:{from_address, subject, body_text, received_at}} or {timed_out:true}; call again on timeout. Pass `since` (ISO 8601) to ignore mail you've already seen.

Parameterssincesecretrequiredaddressrequiredtimeout

list_messages

List received emails

List the last 50 emails received by a mailbox made with create_mailbox, newest first.

Parameterssecretrequiredaddressrequired

Version history

1
  1. v1.0.1LatestNov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Receivemail integrations