mailgun-mcp-server

mailgun-mcp-server — официальный MCP-сервер от mailgun. Работа с API Mailgun: отправка писем и статистика. Ставится через npx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
mailgun
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Отправляет письма и меняет настройки аккаунта Mailgun (шаблоны, вебхуки, маршруты, списки); операций удаления нет.

Настройка клиентов

codex
{
    "code": "codex mcp add mailgun \\\n  --env MAILGUN_API_KEY=YOUR-mailgun-api-key \\\n  -- npx -y @mailgun/mcp-server",
    "lang": "bash",
    "verified": "docs"
}

Что умеет

Mailgun MCP Server — официальный MCP-сервер Mailgun, сервиса отправки электронной почты. Он даёт ИИ-агентам удобный интерфейс, построенный вокруг рабочих задач: отправлять письма, разбираться с доставляемостью и управлять аккаунтом. Сервер работает локально по stdio; облачной версии у Mailgun пока нет.

Возможности:

  • Письма — отправка, получение сохранённых сообщений, повторная отправка.
  • Домены — сведения, проверка DNS, настройки отслеживания кликов, открытий и отписок.
  • Вебхуки, входящие маршруты, списки рассылки и их участники.
  • Шаблоны с версиями — создание, просмотр, изменение.
  • Аналитика и статистика — метрики отправки и использования, журналы событий, сводки по домену, тегу, почтовому сервису, устройству и стране.
  • Подавления — отказы, отписки, жалобы и белый список; классификация отказов.
  • IP-адреса и выделенные пулы, лимиты отправки аккаунта.
  • Проверка адресов (validate), результаты тестов попадания во входящие (optimize) и превью писем в разных клиентах (inspect).

Важная деталь: инструменты ограничены чтением и изменением — операций удаления нет, чтобы ошибка агента не наделала много бед.

Как устроен. Сервер строится по OpenAPI-спецификации Mailgun: при запуске он регистрирует отобранный список эндпоинтов как инструменты MCP. По умолчанию загружаются все инструменты. С --tags dynamic стартует небольшой основной набор (отправка, домены, метрики, журналы, отказы, шаблоны, проверка адреса) и три служебных инструмента: mailgun_list_toolsets, mailgun_enable_toolset и mailgun_call_tool, через которые модель подгружает остальные наборы по мере надобности. Так описание инструментов занимает меньше контекста. Фильтр --tags (или MAILGUN_MCP_TAGS) оставляет только нужное, например validate,inspect.

Кому подойдёт

  • Разработчикам и DevOps, которые отправляют письма приложения через Mailgun.
  • Маркетологам и поддержке, которым нужны статистика доставки и разбор отказов.

Похожие серверы — в категории коммуникации.

Установка

Нужны Node.js 20.12 или новее, аккаунт Mailgun и ключ API. Сервер опубликован в npm как @mailgun/mcp-server и запускается через npx. Переменные: MAILGUN_API_KEY (обязательна), MAILGUN_API_REGION (us по умолчанию или eu), MAILGUN_API_HOSTNAME и MAILGUN_MCP_TAGS.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add mailgun -e MAILGUN_API_KEY=YOUR-mailgun-api-key -- npx -y @mailgun/mcp-server

Для Claude Desktop файл на macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, на Windows — %APPDATA%/Claude/claude_desktop_config.json. Для VS Code блок добавляют в settings.json. В README есть варианты для Cursor, Windsurf и Gemini CLI. Для аккаунта в регионе ЕС укажите MAILGUN_API_REGION со значением eu.

Проверка

В Claude Code выполните /mcp — сервер mailgun должен быть подключён. Затем попросите проверить DNS вашего домена.

Примеры задач

Построй график статистики доставки писем за последнюю неделю.
Какие самые частые причины отказов в моём аккаунте?

Риски

  • Отправка писем от вашего имени реальным получателям.
  • Изменения в аккаунте: шаблоны, вебхуки, маршруты, списки рассылки, настройки доменов. Удаления недоступны.
  • Ключ API храните в переменной окружения; для узких задач ограничьте набор инструментов через --tags.

Частые вопросы

Может ли агент что-то удалить?

Нет, операции удаления не выставлены.

Есть ли облачная версия?

Нет, сервер работает локально.

Как сократить число инструментов?

Используйте --tags dynamic или фильтр по тегам.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники