AI agent'larının kalıcı e-posta gelen kutuları oluşturmasına, tek kullanımlık şifreleri okumasına ve e-posta göndermesine olanak tanır.
Ayrıca bilinen adı MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- 236
- En son sürüm
- 0.9.2
- Son commit
- 13 Kas 2026
- Lisans
- MIT
MailFlat MCP nedir?
MailFlat bir MCP sunucusudur. AI agent'larının kalıcı e-posta gelen kutuları oluşturmasına, tek kullanımlık şifreleri okumasına ve e-posta göndermesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
MailFlat MCP sunucusu hakkında
MailFlat, AI agent'larının ve otomatik test paketlerinin kalıcı e-posta gelen kutularını yönetmesi için bir yöntem sunar. Geliştiriciler, kayıt akışlarını test etmek veya agent iletişimini yönetmek için yararlı olan, birden fazla çalıştırma boyunca devam eden adresler oluşturmak için bu servisi kullanabilirler. Geçici e-posta servislerinin aksine, bu adresler siz mesaj saklama süresini kontrol ederken aktif kalmaya devam eder.
Kullanıcılar, MailFlat dashboard üzerinden alınan mf_live_ ile başlayan bir hesap anahtarı kullanarak servise bağlanırlar. mailflat-mcp paketi, Claude veya Cursor gibi AI asistanlarının bu gelen kutularıyla doğrudan etkileşime girmesine olanak tanır. Sistem; özel etiketlerle yeni gelen kutuları oluşturma, özel geri çağırma araçları aracılığıyla tek kullanımlık şifreleri okuma ve e-posta gönderme gibi belirli görevleri destekler. Bu kurulum, Python, JavaScript ve Java için sunulan çeşitli SDK'lar aracılığıyla hem yerel geliştirme hem de uzak agent ortamları için çalışır.
Neler yapabilirsiniz
- 1Otomatik OTP geri çağırmaBir AI agent, bir kayıt sürecini tamamlamak için bir gelen kutusundan doğrulama kodunu bekleyebilir ve ayıklayabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
MailFlat MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMailFlat MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpMailFlat MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'MailFlat MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP'yi Codex içine yükleyin
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpMailFlat MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mailflat-sdks] command = "uvx" args = ["mailflat-mcp"] [mcp_servers.mailflat-sdks.env] MAILFLAT_API_KEY = "<YOUR_MAILFLAT_API_KEY>"
MailFlat MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpMailFlat MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Yapılandırma
MAILFLAT_API_KEYGerekliGizliMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Ad | Açıklama | Sunucu |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | GerekliGizli |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirmailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyormailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from mailflat-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok31 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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
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.
MailFlat MCP soruları
MailFlat MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
MailFlat MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
MailFlat ile nasıl kimlik doğrulaması yapabilirim?
Agents → API keys bölümünden dashboard üzerinden alabileceğiniz mf_live_ ile başlayan bir hesap anahtarı kullanarak kimlik doğrulaması yapabilirsiniz.
E-posta adresleri geçici mi?
Hayır, adresler kalıcıdır; ancak mesajlar sizin seçtiğiniz bir saklama süresine bağlı olarak sona erer.
Hangi programlama dilleri destekleniyor?
MailFlat; Python, JavaScript/TypeScript, Java için SDK'lar ile LangChain ve Vercel AI SDK için entegrasyonlar sunar.