MCP-сервер UniOne и Unisender Go
mcp-unione
MCP-сервер для транзакционной почты UniOne и Unisender Go с защитой от случайной отправки и офлайн-базой знаний по API
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Может отправлять реальные письма получателям, но только после явного confirm_send=true
- Может удалять шаблоны, вебхуки, домены и записи в списках подавления
Установка
- Работает в
- Сервисы
Ручная установка
uv sync && uv run mcp-unioneУстановка и запуск сервера по stdio из исходников.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Может отправлять реальные письма получателям, но только после явного confirm_send=true
- Может удалять шаблоны, вебхуки, домены и записи в списках подавления
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает транзакционный веб-API UniOne (он же Unisender Go) 32 типизированными инструментами по десяти областям: отправка письма и запрос подписки, проверка адреса, шаблоны, вебхуки, списки подавления, проверка домена и DKIM, выгрузки событий, теги и проекты. Отдельно есть четыре инструмента документации: полнотекстовый поиск по встроенной базе знаний примерно на 4000 строк документации, получение живой страницы документации, расшифровка кода ошибки UniOne с причиной и решением и расшифровка статуса доставки письма. Главная защита: unione_send_email не отправляет письмо по умолчанию, а возвращает предпросмотр получателей, темы и движка, реальная отправка требует явного параметра confirm_send=true, а sandbox=true прогоняет письмо через тестовый домен без реальной доставки.
Для кого. Для разработчиков, которые настраивают транзакционную рассылку через UniOne или Unisender Go и хотят делать это безопасно через агента.
Подходит, если
- Нужно собрать и проверить письмо перед отправкой без риска реальной рассылки
- Нужно разобраться, почему письмо не дошло, по коду ошибки или статусу доставки
- Нужно настроить домен, DKIM, вебхуки или шаблоны без чтения полной документации UniOne
Не подходит, если
- Нет API-ключа UniOne, хотя инструменты документации и базы знаний работают и без него
- Нужна массовая маркетинговая рассылка по большим спискам: сервис и сервер сфокусированы на транзакционных письмах
Пример запроса к агенту
Собери транзакционное письмо о подтверждении заказа через UniOne и покажи предпросмотр, прежде чем отправлятьMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
UNIONE_API_KEYсекрет- Ключ API UniOne, нужен только для реальных вызовов, инструменты документации работают без него.
UNIONE_REGION- Регион API: eu, us или global, по умолчанию eu.
Ограничения
Проект одного автора, но с хорошо развитой инженерией: релизы по semver, публикация образа в GitHub Container Registry и 67 тестов с замоканными HTTP-запросами. Отправка без пометки skip_unsubscribe добавляет футер отписки, который Gmail иногда трактует как маркетинг и уводит письмо во вкладку Промоакции. Опцию skip_unsubscribe сначала нужно включить в самом аккаунте UniOne.
Как отключить. Удалите запись unione из конфигурации MCP клиента или остановите контейнер Docker.
Частые вопросы
Может ли агент случайно отправить письмо?
Нет, unione_send_email без confirm_send=true только показывает предпросмотр и ничего не отправляет, это осознанная защита от случайной отправки.
Работают ли инструменты без API-ключа?
Да, поиск по базе знаний, чтение документации и расшифровка ошибок работают без ключа, он нужен только для реальных вызовов API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыМонорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные
Официальный MCP-сервер Mailtrap: отправка писем, проверка в песочнице, логи доставки, шаблоны, контакты и домены
Официальный MCP-сервер Postmark: 24 инструмента для отправки писем, шаблонов, поиска и разбора доставки.
Open Agent Email — свой почтовый сервер для ИИ-агентов: ящики, ответы в ветке письма, одобрение человеком, вебхуки и MCP на 96 инструментов
Официальный MCP-сервер Resend: отправка и чтение писем, контакты, рассылки, домены и вебхуки из агента
MCP-сервер Atomic Mail: агент сам заводит почтовый ящик на atomicmail.ai и работает с письмами через JMAP без участия человека.
Коротко о README
README на английском подробно описывает быстрый старт через uv и Docker, конфигурацию переменных окружения с регионами API, защиту send guard с подробным объяснением футера отписки и его влияния на попадание в Промоакции, таблицы из 32 инструментов по десяти доменам, 20 ресурсов базы знаний и двух управляемых промптов, а также автоматизированный релизный процесс.