MCP.Market

MailFlat MCP server

by MailFlat·io.github.MailFlat/mailflat-mcp·v0.9.2
No reviews yet

Real email inboxes for AI agents: open an address, read the one-time code, send mail.

B80/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

0 stars51 downloads/wk

Reviews

Write one

Nobody has reviewed MailFlat yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

MailFlat tools (12, 5 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • burn_inboxwrite action

    Delete every message in an inbox but KEEP the address.

  • create_inboxwrite action

    Open an email inbox and return its address. Use this when you need an address to sign up for a service or to receive a one-time code.

  • delete_inboxwrite action

    Delete an inbox and all its messages by address. Irreversible.

  • delete_messagewrite action

    Delete a single message in an inbox by its id (the inbox itself stays).

  • list_inboxes

    List all inboxes available to this API key.

  • mark_read

    Mark one message as read so later polls can skip it.

  • read_messages

    Read messages in the given inbox address (newest first).

  • reply

    Reply to a message so it stays in the SAME conversation.

  • send_emailwrite action

    Send an email FROM the given inbox address (DKIM-signed via MailFlat's MTA). Use for replies or outbound automation. `html` is optional.

  • wait_for_message

    Poll the inbox until a new message ARRIVES (or timeout). Returns {email}.

  • wait_for_otp

    Poll the inbox until an OTP code arrives (or timeout). Returns {otp_code, email}.

  • wait_until_sent

    Find out whether a mail you sent was actually delivered.

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 26 days ago15/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How MailFlat compares

Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 65% of 916 Email servers
Tools
12
the typical Email server has 7
Tools that change things
42%
typical: 25%. Fewer write tools means less an agent can break
Downloads a week
51
more than 36% of 235 Email servers with a package

What its tools let an agent do: 5 read · 1 create · 2 change · 2 delete · 2 send or post

Install MailFlat in Claude Code, Cursor or VS Code

claude mcp add mailflat-mcp -- uvx mailflat-mcp
Add to Cursor

What the publisher says

From the MailFlat repository's README, as published. We do not edit it. Read it on GitHub

MailFlat SDKs

Official client libraries for MailFlat: email inboxes your code owns, with one-line OTP retrieval. Built for test suites (Selenium, pytest, Playwright) and AI agents.

Addresses are permanent, so a suite does not need a fresh one per run. Only the messages expire, on a retention window you choose.

This repo holds only the open-source SDKs. The MailFlat service itself is closed-source.

Packages

Each client is a thin, typed wrapper over the same /api/v1 Agent API, so they behave identically. Authenticate with your account key (mflive…) from the dashboard (Agents → API keys).

Java / Selenium (JitPack)

JitPack derives the groupId from the GitHub owner. This repo moved to the official

MailFlat account in August 2026, so releases from v0.4.4 on publish as

com.github.MailFlat:mailflat-sdks. Earlier versions still resolve under the old

coordinate com.github.onderyentar21:mailflat-sdks; the old repo stays up for them.

The client is moving to Maven Central (net.mailflat) next, which ends the owner coupling.

<repositories>
  <repository><id>jitpack.io</id><url>https://jitpack.io</url></repository>
</repositories>

<dependency>
  <groupId>com.github.MailFlat</groupId>
  <artifactId>mailflat-sdks</artifactId>
  <version>v0.4.5</version>
</dependency>
MailFlat mf = new MailFlat("mf_live_…");
Inbox inbox = mf.create("signup");
driver.findElement(By.id("email")).sendKeys(inbox.address());
String otp = inbox.waitForOtp(30);          // polls until the code arrives
driver.findElement(By.id("code")).sendKeys(otp);

Quick examples

Python

from mailflat import MailFlat
mf = MailFlat(api_key="mf_live_…")
inbox = mf.create(label="signup")
otp = inbox.wait_for_otp(timeout=30)

JavaScript / TypeScript

import { MailFlat } from "@mailflat/sdk";
const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY });
const inbox = await mf.create({ label: "signup" });
const otp = await inbox.waitForOtp({ timeout: 30000 });

License

MIT. The full text is in LICENSE at the repository root; each package directory carries an identical copy.

Nothing above is checked by us. What we check is on the safety report.

MailFlat: common questions

Is MailFlat MCP server safe?
Mostly: it is graded B (80/100). Read the MailFlat safety report
How do I install MailFlat?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does MailFlat need an API key?
Yes. The registry entry asks for MAILFLAT_API_KEY.
Is MailFlat maintained?
The last commit was 32 days ago (2026-10-05). The latest release is v0.9.2.
What can I use instead of MailFlat?
Servers from other publishers that do the same job: Agenticmail MCP server, Openagentemail MCP server and Agent Email MCP server. Compare all MailFlat alternatives.
How does MailFlat compare with other Email MCP servers?
safety score 80/100 (higher than 65% of 916 Email servers); tools 12 (the typical Email server has 7); tools that change things 42% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to MailFlat

Same job from other publishers: the closest match first, then the best rated.

All MailFlat alternatives →
  • Agenticmail
    Real email and SMS for AI agents — send mail, receive verification codes, drive a real inbox.
    B
  • Openagentemail
    Unlimited agent mailboxes — create identities, read/wait for mail, extract OTPs, send email.
    B
  • Agent Email
    Local email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP
    A
  • send0
    Email inboxes for AI agents: create an address, wait for codes and links, send and reply in threads.
    A
  • Proton Mail (unofficial)
    Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP
    B