Permet aux agents IA de créer des boîtes de réception e-mail permanentes, de lire des mots de passe à usage unique et d'envoyer des e-mails.
Aussi connu sous MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- 236
- Dernière version
- 0.9.2
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que MailFlat MCP ?
Permet aux agents IA de créer des boîtes de réception e-mail permanentes, de lire des mots de passe à usage unique et d'envoyer des e-mails.
Résumé généré à partir du README du projet
À propos du MCP server MailFlat
MailFlat offre aux agents IA et aux suites de tests automatisés un moyen de gérer des boîtes de réception e-mail permanentes. Les développeurs peuvent utiliser ce service pour créer des adresses qui persistent à travers plusieurs exécutions, ce qui est utile pour tester des flux d'inscription ou gérer les communications d'un agent. Contrairement aux services d'e-mails temporaires, ces adresses restent actives tandis que vous contrôlez la fenêtre de rétention des messages.
Les utilisateurs se connectent au service via une clé de compte commençant par mf_live_ obtenue depuis le tableau de bord MailFlat. Le package mailflat-mcp permet aux assistants IA comme Claude ou Cursor d'interagir directement avec ces boîtes de réception. Le système prend en charge des tâches spécifiques telles que la création de nouvelles boîtes avec des labels personnalisés, la lecture de mots de passe à usage unique via des outils de récupération spécialisés et l'envoi d'e-mails. Cette configuration fonctionne aussi bien pour le développement local que pour les environnements d'agents distants grâce à divers SDK pour Python, JavaScript et Java.
Ce que vous pouvez faire avec
- 1Récupération automatisée d'OTPUn agent IA peut attendre et extraire un code de vérification depuis une boîte de réception pour finaliser un processus d'inscription.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer MailFlat MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller MailFlat MCP dans Claude Code
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpInstaller MailFlat MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Installer MailFlat MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Installer MailFlat MCP dans VS Code CLI
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Installer MailFlat MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Installer MailFlat MCP dans Codex
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpInstaller MailFlat MCP dans 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>"
Installer MailFlat MCP dans Gemini CLI
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpInstaller MailFlat MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Configuration
MAILFLAT_API_KEYRequisSecretMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Nom | Description | Type |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | RequisSecret |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblemailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Réussi
- Le nom du package correspond au dépôt sourcemailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from mailflat-mcpRéussi
- Aucun avis critique dans le package ou ses dépendances31 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur MailFlat MCP
Comment ajouter MailFlat MCP à Claude Code ?
Exécutez claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter MailFlat MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment s'authentifier avec MailFlat ?
L'authentification s'effectue à l'aide d'une clé de compte (commençant par mf_live_...) obtenue depuis le tableau de bord sous Agents → API keys.
Les adresses e-mail sont-elles temporaires ?
Non, les adresses sont permanentes, bien que les messages expirent selon une fenêtre de rétention que vous sélectionnez.
Quels langages de programmation sont pris en charge ?
MailFlat propose des SDK pour Python, JavaScript/TypeScript, Java, ainsi que des intégrations pour LangChain et Vercel AI SDK.