Permite que los agentes de IA creen bandejas de entrada de correo permanentes, lean contraseñas de un solo uso y envíen correos electrónicos.
También conocido como MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- 236
- Última versión
- 0.9.2
- Último commit
- 13 nov 2026
- Licencia
- MIT
¿Qué es MailFlat MCP?
Permite que los agentes de IA creen bandejas de entrada de correo permanentes, lean contraseñas de un solo uso y envíen correos electrónicos.
Resumen generado a partir del README del proyecto
Acerca del MCP server de MailFlat
MailFlat ofrece una forma para que los agentes de IA y las suites de pruebas automatizadas gestionen bandejas de entrada de correo permanentes. Los desarrolladores pueden usar este servicio para crear direcciones que persistan a través de múltiples ejecuciones, lo cual es útil para probar flujos de registro o gestionar comunicaciones de agentes. A diferencia de los servicios de correo temporal, estas direcciones permanecen activas mientras tú controles el periodo de retención de mensajes.
Los usuarios se conectan al servicio usando una clave de cuenta que comienza con mf_live_ obtenida desde el dashboard de MailFlat. El paquete mailflat-mcp permite que asistentes de IA como Claude o Cursor interactúen con estas bandejas de entrada directamente. El sistema soporta tareas específicas como crear nuevas bandejas con etiquetas personalizadas, leer contraseñas de un solo uso mediante herramientas de recuperación especializadas y enviar correos electrónicos. Esta configuración funciona tanto para desarrollo local como para entornos de agentes remotos a través de varios SDKs para Python, JavaScript y Java.
Qué puedes hacer con él
- 1Recuperación automatizada de OTPUn agente de IA puede esperar y extraer un código de verificación de una bandeja de entrada para completar un proceso de registro.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar MailFlat MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar MailFlat MCP en Claude Code
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpInstalar MailFlat MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instalar MailFlat MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instalar MailFlat MCP en VS Code CLI
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Instalar MailFlat MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Instalar MailFlat MCP en Codex
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpInstalar MailFlat MCP en 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>"
Instalar MailFlat MCP en Gemini CLI
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpInstalar MailFlat MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Configuración
MAILFLAT_API_KEYObligatorioSecretoMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Nombre | Descripción | Tipo |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | ObligatorioSecreto |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblemailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Aprobado
- El paquete indica este repositorio como su origenmailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from mailflat-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias31 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre MailFlat MCP
¿Cómo agrego MailFlat MCP a Claude Code?
Ejecuta claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego MailFlat MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo me autentico con MailFlat?
Te autenticas usando una clave de cuenta (que comienza con mf_live_...) obtenida desde el dashboard en Agents → API keys.
¿Las direcciones de correo son temporales?
No, las direcciones son permanentes, aunque los mensajes caducan según el periodo de retención que selecciones.
¿Qué lenguajes de programación son compatibles?
MailFlat ofrece SDKs para Python, JavaScript/TypeScript, Java, e integraciones para LangChain y Vercel AI SDK.