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