MailFlat

io.github.MailFlat由 GitHub 账号 MailFlat 发布v0.9.2更新于 Oct 24, 2026

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

发布方自己的服务：FlatCash — Native Currency for AI Agents

已验证STDIO仅桌面开发者工具沟通与协作

服务详情

标识符: io.github.MailFlat/mailflat-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 MailFlat。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.MailFlat%2Fmailflat-mcp.svg)](https://sourceweft.com/mcp/io.github.MailFlat%2Fmailflat-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

MailFlat 为 AI 助手提供真实邮箱：开通地址、读取一次性验证码并发送邮件。

可以做什么: 创建并管理账号名下的永久邮箱地址，可按用途打标签，并在多次运行间复用，无需每次新建地址。读取收到的邮件并获取一次性验证码，可在超时时间内等待验证码到达。从邮箱发送邮件。邮件按你选择的保留期限过期，而地址本身保持永久。
适用场景: 适用于助手需要完成依赖邮件验证的注册或登录流程，或测试套件与智能体需要一个稳定邮箱来接收和读取验证码与邮件的情况。
运行要求: 通过 PyPI 包 mailflat-mcp 在用户本机以本地进程运行，通常用 uvx 启动，因此需要 Python 运行环境。需要 MailFlat 账号，并在 MAILFLAT_API_KEY 环境变量中提供 API 密钥，密钥在控制台的 Agents 页面创建。需要访问 MailFlat API 的网络连接；可用 MAILFLAT_API_URL 覆盖基础地址。

安装前请注意

API 密钥是有效的账号凭据，请勿写入日志或共享配置。助手可以读取收件内容并从你的邮箱发送邮件，请留意其操作。邮件由闭源的 MailFlat 服务处理，邮件会按你设定的保留期限过期。

安装

在 SourceWeft 中

打开控制台中的 MailFlat，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

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

Package	For	Install
`mailflat`	Python	`pip install mailflat`
`@mailflat/sdk`	JavaScript / TypeScript	`npm i @mailflat/sdk`
`mailflat-mcp`	AI assistants (Claude, Cursor) — MCP	`uvx mailflat-mcp`
`@mailflat/ai-sdk`	Vercel AI SDK agents	`npm i @mailflat/ai-sdk`
`mailflat.langchain`	LangChain agents	`pip install "mailflat[langchain]"`
`mailflat-sdk` (Java)	Java / Selenium	via JitPack — see below

Each client is a thin, typed wrapper over the same /api/v1 Agent API, so they behave identically. Authenticate with your account key (mf_live_…) 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.

xml

<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.8.1</version></dependency>

<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.8.1</version></dependency>

java

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 arrivesdriver.findElement(By.id("code")).sendKeys(otp);

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 arrivesdriver.findElement(By.id("code")).sendKeys(otp);

Quick examples

Python

python

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

from mailflat import MailFlatmf = 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 });

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 });