Memungkinkan AI agent untuk membuat inbox email permanen, membaca one-time password, dan mengirim email.
Juga dikenal sebagai MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- 236
- Versi terbaru
- 0.9.2
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu MailFlat MCP?
Memungkinkan AI agent untuk membuat inbox email permanen, membaca one-time password, dan mengirim email.
Ringkasan dibuat dari README proyek
Tentang MailFlat MCP server
MailFlat menyediakan cara bagi AI agent dan suite pengujian otomatis untuk mengelola inbox email permanen. Developer dapat menggunakan layanan ini untuk membuat alamat email yang tetap ada di berbagai sesi penggunaan, yang sangat berguna untuk menguji alur registrasi atau mengelola komunikasi agent. Berbeda dengan layanan email sementara, alamat ini tetap aktif sementara Anda memegang kendali atas jendela retensi pesan.
User terhubung ke layanan menggunakan account key yang dimulai dengan mf_live_ yang didapatkan dari dashboard MailFlat. Package mailflat-mcp memungkinkan AI assistant seperti Claude atau Cursor untuk berinteraksi langsung dengan inbox ini. Sistem ini mendukung tugas-tugas spesifik seperti membuat inbox baru dengan label kustom, membaca one-time password melalui tool pengambilan khusus, dan mengirim email. Setup ini berfungsi baik untuk pengembangan lokal maupun lingkungan agent remote melalui berbagai SDK untuk Python, JavaScript, dan Java.
Apa yang bisa Anda lakukan dengannya
- 1Pengambilan OTP otomatisAI agent dapat menunggu dan mengekstrak kode verifikasi dari sebuah inbox untuk menyelesaikan proses pendaftaran.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal MailFlat MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal MailFlat MCP di Claude Code
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpInstal MailFlat MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instal MailFlat MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instal MailFlat MCP di VS Code CLI
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Instal MailFlat MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instal MailFlat MCP di Codex
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpInstal MailFlat MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mailflat-sdks] command = "uvx" args = ["mailflat-mcp"] [mcp_servers.mailflat-sdks.env] MAILFLAT_API_KEY = "<YOUR_MAILFLAT_API_KEY>"
Instal MailFlat MCP di Gemini CLI
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpInstal MailFlat MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Konfigurasi
MAILFLAT_API_KEYWajibRahasiaMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Nama | Deskripsi | Tipe |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | WajibRahasia |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaumailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyamailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from mailflat-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya31 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubMailFlat 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
groupIdfrom the GitHub owner. This repo moved to the officialMailFlataccount in August 2026, so releases fromv0.4.4on publish ascom.github.MailFlat:mailflat-sdks. Earlier versions still resolve under the old coordinatecom.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.8.1</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.
Pertanyaan tentang MailFlat MCP
Bagaimana cara menambahkan MailFlat MCP ke Claude Code?
Jalankan claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan MailFlat MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara autentikasi dengan MailFlat?
Anda melakukan autentikasi menggunakan account key (yang dimulai dengan mf_live_...) yang didapatkan dari dashboard di bagian Agents → API keys.
Apakah alamat emailnya bersifat sementara?
Tidak, alamat emailnya bersifat permanen, meskipun pesan akan kedaluwarsa berdasarkan jendela retensi yang Anda pilih.
Bahasa pemrograman apa saja yang didukung?
MailFlat menyediakan SDK untuk Python, JavaScript/TypeScript, Java, serta integrasi untuk LangChain dan Vercel AI SDK.