Позволяет AI-агентам создавать постоянные почтовые ящики, считывать одноразовые пароли и отправлять электронные письма.
Также известен как MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- 236
- Последняя версия
- 0.9.2
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- MIT
Что такое MailFlat MCP?
Позволяет AI-агентам создавать постоянные почтовые ящики, считывать одноразовые пароли и отправлять электронные письма.
Сводка сгенерирована из README проекта
О MailFlat MCP server
MailFlat предоставляет способ управления постоянными почтовыми ящиками для AI-агентов и автоматизированных наборов тестов. Разработчики могут использовать этот сервис для создания адресов, которые сохраняются между запусками, что полезно для тестирования процессов регистрации или управления коммуникациями агентов. В отличие от сервисов временной почты, эти адреса остаются активными, при этом вы сами контролируете срок хранения сообщений.
Пользователи подключаются к сервису с помощью ключа аккаунта, начинающегося с mf_live_, который можно получить в панели управления MailFlat. Пакет mailflat-mcp позволяет таким AI-ассистентам, как Claude или Cursor, напрямую взаимодействовать с этими почтовыми ящиками. Система поддерживает выполнение конкретных задач, таких как создание новых ящиков с пользовательскими метками, чтение одноразовых паролей через специализированные инструменты получения данных и отправка писем. Эта конфигурация подходит как для локальной разработки, так и для удаленных сред агентов благодаря различным SDK для Python, JavaScript и Java.
Что вы можете с ним делать
- 1Автоматическое получение OTPAI-агент может ожидать и извлекать проверочный код из почтового ящика для завершения процесса регистрации.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить MailFlat MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка MailFlat MCP в Claude Code
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpУстановка MailFlat MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Установка MailFlat MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Установка MailFlat MCP в VS Code CLI
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Установка MailFlat MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Установка MailFlat MCP в Codex
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpУстановка MailFlat MCP в 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>"
Установка MailFlat MCP в Gemini CLI
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpУстановка MailFlat MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Конфигурация
MAILFLAT_API_KEYОбязательноСекретMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| Название | Описание | Тип |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | ОбязательноСекрет |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийmailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗Пройдено
- Пакет указывает этот репозиторий как источникmailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from mailflat-mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях31 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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.
Вопросы о MailFlat MCP
Как добавить MailFlat MCP в Claude Code?
Выполните claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить MailFlat MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как пройти аутентификацию в MailFlat?
Вы проходите аутентификацию с помощью ключа аккаунта (начинается с mf_live_...), который можно получить в панели управления в разделе Agents → API keys.
Являются ли адреса электронной почты временными?
Нет, адреса постоянные, хотя срок хранения сообщений ограничен выбранным вами окном удержания данных.
Какие языки программирования поддерживаются?
MailFlat предоставляет SDK для Python, JavaScript/TypeScript, Java, а также интеграции для LangChain и Vercel AI SDK.