Ermöglicht es AI Agents, permanente E-Mail-Postfächer zu erstellen, Einmalpasswörter (OTPs) zu lesen und E-Mails zu versenden.
Auch bekannt als MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- 236
- Neueste Version
- 0.9.2
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- MIT
Was ist MailFlat MCP?
MailFlat ist ein MCP server. Ermöglicht es AI Agents, permanente E-Mail-Postfächer zu erstellen, Einmalpasswörter (OTPs) zu lesen und E-Mails zu versenden.
Zusammenfassung generiert aus dem README des Projekts
Über MailFlat MCP server
MailFlat bietet eine Möglichkeit für AI Agents und automatisierte Test-Suites, permanente E-Mail-Postfächer zu verwalten. Entwickler können diesen Service nutzen, um Adressen zu erstellen, die über mehrere Durchläufe hinweg bestehen bleiben, was besonders nützlich für das Testen von Registrierungsprozessen oder die Verwaltung der Kommunikation von Agents ist. Im Gegensatz zu temporären E-Mail-Diensten bleiben diese Adressen aktiv, während du die Aufbewahrungsfrist für Nachrichten selbst kontrollierst.
Nutzer verbinden sich mit dem Service über einen Account Key, der mit mf_live_ beginnt und im MailFlat-Dashboard abgerufen wird. Das mailflat-mcp Package ermöglicht es AI Assistants wie Claude oder Cursor, direkt mit diesen Postfächern zu interagieren. Das System unterstützt spezifische Aufgaben wie das Erstellen neuer Postfächer mit benutzerdefinierten Labels, das Lesen von Einmalpasswörtern über spezialisierte Retrieval-Tools und das Versenden von E-Mails. Dieses Setup funktioniert sowohl für die lokale Entwicklung als auch für Remote-Agent-Umgebungen über verschiedene SDKs für Python, JavaScript und Java.
Was du damit machen kannst
- 1Automatisierte OTP-AbfrageEin AI Agent kann auf einen Verifizierungscode in einem Postfach warten und diesen extrahieren, um einen Registrierungsprozess abzuschließen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du MailFlat MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenMailFlat MCP in Claude Code installieren
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpMailFlat MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'MailFlat MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}MailFlat MCP in Codex installieren
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpMailFlat MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpMailFlat MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Konfiguration
MAILFLAT_API_KEYErforderlichSecretMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Name | Beschreibung | Typ |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | ErforderlichSecret |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarmailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Bestanden
- Paket nennt dieses Repository als Quellemailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from mailflat-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten31 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenMailFlat 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 Fragen
Wie füge ich MailFlat MCP zu Claude Code hinzu?
Führe claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich MailFlat MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie authentifiziere ich mich bei MailFlat?
Du authentifizierst dich mit einem Account Key (beginnend mit mf_live_...), den du im Dashboard unter Agents → API keys erhältst.
Sind die E-Mail-Adressen temporär?
Nein, die Adressen sind permanent, wobei Nachrichten basierend auf einem von dir gewählten Aufbewahrungszeitraum ablaufen.
Welche Programmiersprachen werden unterstützt?
MailFlat bietet SDKs für Python, JavaScript/TypeScript, Java sowie Integrationen für LangChain und das Vercel AI SDK.