model context protocol · 6 tools

The MCP email tool for your agent

A native MCP server that gives any agent inbox tools: create, read, wait for OTP, send and delete. Runs with one command.

Get an agent key Email for AI agents

Works everywhere MCP does

Claude Desktop, Cursor, Hermes, OpenClaw and any Model Context Protocol client.

Six tools out of the box

create_inbox, list_inboxes, read_messages, wait_for_otp, send_email, delete_inbox.

Zero install

uvx mailflat-mcp runs it isolated, with no setup beyond an API key.

What MCP changes

Model Context Protocol is how a desktop AI client hands a model real tools. The client starts a small server process, asks what it can do, and from then on the model calls those capabilities by name. No browser automation, no copy-pasting a verification code out of a webmail tab.

The MailFlat MCP server exposes the inbox as tools: open an address, read what arrived, wait for a one-time code, send mail, check whether it went out, and clean up afterwards.

Setup is one config block

The server runs with no install step through uvx, or you can install it once. Point your client's config at it, put your API key in the environment, and restart the client. The tools appear in the model's list on the next conversation.

It works with any MCP client. Claude Desktop and Cursor have their own pages here because their config files live in different places and that is the only part people get stuck on.

Two things worth knowing before you wire it up

First, an end-to-end encrypted inbox cannot hand the model a one-time code. The server would have to read the message to find it, and encryption means it cannot. Use an unencrypted inbox when you want automatic code extraction.

Second, sending is accepted rather than completed, because delivery happens on a queue. There is a tool for asking what became of a specific message, and it deliberately answers "still queued" differently from "failed", so the model does not resend a message that is merely in flight.

Read the details

MCP server referenceEvery tool, its arguments, and the config block.Claude Desktop setupWhere the config file lives and what to put in it.Cursor setupThe same server, wired into Cursor.Encryption and OTPWhy an encrypted inbox cannot extract codes for you.

{ "mcpServers": {
    "mailflat": {
      "command": "uvx",
      "args": ["mailflat-mcp"],
      "env": { "MAILFLAT_API_KEY": "mf_live_..." }
    } } }

Frequently asked questions

How do I run it?

uvx mailflat-mcp, or add it to your client's MCP config with your MAILFLAT_API_KEY.

Which clients are supported?

Any MCP-compatible client: Claude Desktop, Cursor, Hermes, OpenClaw and more.

What can the agent do?

Create and list inboxes, read messages, wait for OTPs, send DKIM-signed mail and delete inboxes.

email for ai agents temporary email api email testing api

Ready to try it?

Get an agent key

MailFlat for instant email inboxes for testing, automation & AI agents.