Добавить сервер
railsware/mailtrap-mcp
  1. Каталог MCP
  2. railsware/mailtrap-mcp

railsware/mailtrap-mcp

от railsware
MCP сервер для отправки email и тестирования в песочнице Mailtrap. Отправляйте письма, управляйте шаблонами, просматривайте логи доставки и статистику. Помогает разработчикам отлаживать email-функциональность через AI.
GithubNPMСайт сервера

TypeScript test NPM

Official Mailtrap MCP Server

The official MCP server for Mailtrap — the email delivery platform. It connects your Mailtrap account to Claude, Cursor, VS Code, and other MCP-compatible AI assistants.

Send transactional and bulk email, test messages safely in Email Sandbox, manage templates, contacts, sending domains, and webhooks, inspect email logs and delivery statistics, troubleshoot deliverability, and manage account resources — all using natural-language prompts.

Capabilities

  • Email API and SMTP — Send transactional and bulk email, including batch and template-based messages.
  • Email testing — Test messages in Email Sandbox and inspect content, headers, attachments, spam scores, and HTML client compatibility.
  • Delivery monitoring — Search email logs, inspect event history, and analyze delivery, bounce, open, click, and spam rates.
  • Email infrastructure — Manage sending domains, DNS verification, webhooks, and suppressions.
  • Contacts — Manage contacts, lists, custom fields, and events, with imports and exports.
  • Account management — Review billing usage and manage access, permissions, API tokens, and sub-accounts.

Часто задаваемые вопросы

Инструменты были проиндексированы:
batch-send-bulk-email

Отправляет пакет массовых писем (Mailtrap bulk-stream API) за один вызов. Общие поля помещаются в base; переопределения для каждого получателя помещаются в requests[]. Каждый запрос должен включать хотя бы одно из полей to, cc или bcc.

Параметры
  • baseobject

    Общие поля применяются к каждому запросу в пакете. Каждый запрос может переопределять отдельные поля.

  • requestsobject[]обязательный

    Сообщения для каждого получателя. Каждый запрос должен включать хотя бы одного получателя через to, cc или bcc; другие поля переопределяют base.

batch-send-sandbox-email

Отправляет пакет писем в песочнице в тестовый ящик одним вызовом API Mailtrap. Общие поля указываются в base; переопределения для каждого получателя — в requests[]. Требуется sandbox_id или переменная окружения MAILTRAP_SANDBOX_ID.

Параметры
  • baseobject

    Общие поля применяются к каждому запросу в пакете. Каждый запрос может переопределять отдельные поля.

  • requestsobject[]обязательный

    Сообщения для каждого получателя. Каждый запрос должен включать хотя бы одного получателя через to, cc или bcc; другие поля переопределяют base.

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

batch-send-transactional-email

Отправляет пакет транзакционных писем за один вызов API Mailtrap. Общие поля указываются в base; переопределения для каждого получателя — в requests[]. Каждый запрос должен включать to.

Параметры
  • baseobject

    Общие поля применяются к каждому запросу в пакете. Каждый запрос может переопределять отдельные поля.

  • requestsobject[]обязательный

    Сообщения для каждого получателя. Каждый запрос должен включать хотя бы одного получателя через to, cc или bcc; другие поля переопределяют base.

bulk-update-permissions

Массово создаёт, обновляет или удаляет разрешения для доступа к аккаунту. Существующие пары (resource_type, resource_id) обновляются, новые создаются. Укажите destroy: true, чтобы удалить.

Параметры
  • account_access_idnumberобязательный

    ID доступа к аккаунту, чьи разрешения обновляются.

  • permissionsobject[]обязательный

    Записи разрешений можно создавать, обновлять или удалять. Комбинации resource_type + resource_id, которые уже существуют, обновляются; новые комбинации создаются. Установите destroy: true, чтобы удалить существующее разрешение.

cancel-email-campaign

Отменяет запланированную email-кампанию, возвращая её в статус draft; отменить можно только запланированные кампании.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты для отмены.

clean-sandbox-inbox

Удаляет все сообщения из инбокса песочницы, не удаляя сам инбокс.

Параметры
  • inbox_idnumber

    Устаревший псевдоним для sandbox_id в инструментах sandbox inbox.

  • sandbox_idnumber

    Предпочтительно. ID песочницы (тестового входящего ящика). Для get-sandbox-inbox необязателен, если задан MAILTRAP_SANDBOX_ID.

create-api-token

Создаёт новый API токен. Ответ включает секретное значение token: это единственный раз, когда возвращается полный токен, поэтому сохраните его сразу.

Параметры
  • expires_atstring | null

    Необязательный срок действия токена, задаваемый как дата и время в формате ISO 8601 (например, 2027-06-01T00:00:00Z). Опустите параметр, чтобы использовать значение по умолчанию на сервере (1 год). Передайте явное значение null для токена, который не истекает никогда. Значения в прошлом или более чем на 5 лет вперед отклоняются с ошибкой 422.

  • namestringобязательный

    Отображаемое имя для API-токена.

  • resourcesobject[]

    Необязательный список разрешений на ресурсы для прикрепления к токену. Каждая запись привязывает токен к конкретному ресурсу на заданном уровне доступа.

create-company-info

Устанавливает информацию о компании для отправляющего домена, необходимую для проверки соответствия домена.

Параметры
  • addressstringобязательный

    Уличный адрес.

  • citystringобязательный

    Город

  • countrystringобязательный

    Страна

  • info_levelenum

    Является ли отправитель юридическим лицом или частным лицом.

  • namestringобязательный

    Название компании или имя физического лица.

  • phonestring

    Номер телефона.

  • privacy_policy_urlstring

    URL страницы политики конфиденциальности.

  • sending_domain_idintegerобязательный

    Отправка ID домена

  • terms_of_service_urlstring

    URL страницы с условиями использования.

  • website_urlstringобязательный

    URL сайта компании

  • zip_codestringобязательный

    Почтовый индекс.

create-contact

Создаёт новый контакт. Требует email; опционально принимает пользовательские fields, list_ids для подписки и unsubscribed для начала в статусе отписки.

Параметры
  • emailstringобязательный

    Электронная почта контакта.

  • fieldsobject

    Значения пользовательских полей, привязанные к merge-тегу поля (например, first_name). Значения могут быть строкой, числом или булевым значением.

  • list_idsnumber[]

    Идентификаторы списков контактов, в которые нужно добавить этот контакт.

  • unsubscribedboolean

    Если true, контакт создается в статусе unsubscribed.

create-contact-event

Записывает событие контакта (по name + произвольные params) для идентификатора контакта или email. Используется для запуска автоматизаций.

Параметры
  • contact_identifierstringобязательный

    Идентификатор контакта или email для привязки события.

  • namestringобязательный

    Название события. Используется для сопоставления автоматизаций в списке контактов, запускаемых этим событием.

  • paramsobjectобязательный

    Произвольные пары ключ/значение для события. Значения могут быть строкой, числом, логическим значением или null.

create-contact-export

Экспортирует контакты, соответствующие набору фильтров, объединённых по И. Возвращает задание на экспорт; опрашивайте статус с помощью get-contact-export, чтобы получить URL для скачивания.

Параметры
  • filtersobject[]обязательный

    Фильтры, определяющие, какие контакты включить в экспорт. Объединены по логике И.

create-contact-field

Создаёт новое определение поля контакта. merge_tag должен быть уникальным и используется в переменных шаблона.

Параметры
  • data_typeenumобязательный

    Тип данных, хранящихся в этом поле.

  • merge_tagstringобязательный

    Merge-тег, используемый в переменных шаблона (например, first_name). Должен быть уникальным.

  • namestringобязательный

    Отображаемое имя поля (например, «Имя»).

create-contact-import

Массово импортирует контакты. Возвращает запись задания импорта; опрашивайте статус через get-contact-import.

Параметры
  • contactsobject[]обязательный

    Контакты для импорта. Каждая запись должна содержать как минимум email; по желанию можно включить пользовательские fields, list_ids_included и list_ids_excluded.

create-contact-list

Создает новый список контактов.

Параметры
  • namestringобязательный

    Название для нового списка контактов.

create-email-campaign

Создаёт новую email-кампанию в статусе draft; требует указания name, domain_id, from_local_part и template_attributes.subject.

Параметры
  • contact_list_idsinteger[]

    Идентификаторы списков контактов для отправки. Рассматриваются как полный набор включённых списков. Комбинируйте с contact_segment_ids, чтобы охватить оба.

  • contact_segment_idsinteger[]

    Идентификаторы сегментов контактов, на которые отправляется сообщение. Рассматриваются как полный набор включённых сегментов.

  • delivery_modeenum

    Как доставляется кампания. rapid отправляет как можно быстрее; gradual ограничивает отправку до delivery_options.emails_per_hour.

  • delivery_optionsobject

    Варианты ограничения доставки. Применяется, когда delivery_mode имеет значение gradual.

  • domain_idintegerобязательный

    Идентификатор подтвержденного домена отправителя, используемого для кампании, возвращаемый конечными точками Sending Domains.

  • from_display_namestring

    Отображаемое имя в заголовке From.

  • from_local_partstringобязательный

    Локальная часть (перед @) адреса From.

  • namestringобязательный

    Название кампании

  • reply_toobject

    Части адреса Reply-To.

  • template_attributesobjectобязательный

    Встроенный шаблон электронного письма — тема и дизайн кампании.

create-inbound-folder

Создаёт новую входящую папку.

Параметры
  • namestringобязательный

    Имя папки.

create-inbound-inbox

Создаёт новый входящий почтовый ящик в папке. Опускайте domain_id для ящика, размещённого на Mailtrap; передавайте его для ящика с собственным доменом (catch-all).

Параметры
  • domain_idnumber

    Необязательно. Привязывает входящий ящик к пользовательскому домену отправки (catch-all inbox). Опускает для стандартного входящего ящика, размещенного на Mailtrap.

  • folder_idnumberобязательный

    Идентификатор входящей папки, в которой нужно создать почтовый ящик.

  • namestringобязательный

    Имя входящих.

create-sandbox-inbox

Создаёт новый тестовый почтовый ящик (sandbox) в проекте. Возвращает SMTP-учётные данные для нового ящика.

Параметры
  • namestringобязательный

    Название входящих

  • project_idnumberобязательный

    ID проекта, в котором создать инбокс

create-sandbox-project

Создаёт новый песочный проект для группировки тестовых почтовых ящиков.

Параметры
  • namestringобязательный

    Название проекта (2–100 символов)

create-sending-domain

Чтобы создать новый домен отправки, выполните следующие шаги: 1. Укажите доменное имя. Введите домен, который будет использоваться для отправки писем (например, send.yourdomain.com). 2. Проверьте права на домен. Система сгенерирует набор DNS-записей (обычно TXT-запись для верификации, CNAME для отслеживания кликов/открытий, MX-запись для обработки возвратов). Добавьте их у регистратора вашего домена. 3. Дождитесь подтверждения. После добавления записей запустите проверку DNS. Обычно это занимает от нескольких минут до 48 часов. 4. Настройте SPF и DKIM. Убедитесь, что авторизация писем (SPF, DKIM) корректна — это критично для доставляемости. 5. Назначьте домен по умолчанию (опционально). Если это ваш основной домен отправки, отметьте его как основной. После успешной проверки домен будет готов к отправке писем. Если нужна помощь с конкретными DNS-записями или провайдером — дайте знать.

Параметры
  • domain_namestringобязательный

    Доменное имя (например, example.com)

create-sub-account

Создаёт новый подаккаунт в организации. Требует MAILTRAP_ORGANIZATION_ID и права управления подаккаунтами.

Параметры
  • namestringобязательный

    Отображаемое имя для нового субаккаунта.

create-suppression

Добавьте адрес электронной почты в список подавления аккаунта, чтобы Mailtrap прекратил доставку на него.

Параметры
  • domain_idintegerобязательный

    Идентификатор отправляющего домена, на который распространяется подавление, возвращаемый инструментами Sending Domains.

  • emailstringобязательный

    Email-адрес для исключения

  • sending_streamenumобязательный

    Отправка потока для подавления адреса.

  • typeenum

    Причина, записанная для подавления. По умолчанию — manual import, если не указано.

create-template

Создаёт новый шаблон электронного письма

Параметры
  • categorystring

    Категория шаблона (необязательно, по умолчанию: 'General')

  • htmlstring

    HTML-содержимое шаблона (необязательно)

  • namestringобязательный

    Название шаблона

  • subjectstringобязательный

    Тема письма

  • textstring

    Версия в виде простого текста (необязательно)

create-tracking-opt-out

Исключите адрес электронной почты из отслеживания открытий и кликов для домена отправителя.

Параметры
  • domain_idintegerобязательный

    ID домена отправителя, на который распространяется отказ от подписки, возвращаемый инструментами Sending Domains.

  • emailstringобязательный

    Адрес электронной почты для отказа от отслеживания открытий и кликов.

create-webhook

Создаёт вебхук. Параметр webhook_type может принимать значения email_sending, audit_log или inbound_receiving; для inbound_receiving параметр inbound_inbox_id необязателен (ограничивает вебхук одним почтовым ящиком - опустите, чтобы применить ко всем почтовым ящикам). Ответ включает signing_secret для проверки подписей полезной нагрузки вебхука - этот секрет возвращается только при создании, сохраните его сейчас.

Параметры
  • activeboolean

    Определяет, включен ли вебхук. По умолчанию — true.

  • domain_idnumber

    ID домена отправителя для ограничения этого вебхука. Применяется только к вебхукам email_sending.

  • event_typesenum[]

    События для подписки. Применяется только к вебхукам email_sending.

  • inbound_inbox_idnumber

    ID входящего почтового ящика, к которому привязан вебхук. Применимо только для вебхуков inbound_receiving; необязательно — опустите, чтобы применить ко всем почтовым ящикам в аккаунте.

  • payload_formatenum

    Кодировка полезной нагрузки. По умолчанию — json.

  • sending_streamenum

    Поток отправки, на который подписан этот вебхук. Применяется только к вебхукам email_sending.

  • urlstringобязательный

    URL, на который Mailtrap будет отправлять события вебхуков через POST.

  • webhook_typeenumобязательный

    Категория вебхука. email_sending для событий доставки, открытия, кликов и т.д., audit_log для событий аудита аккаунта, inbound_receiving для событий входящих сообщений.

delete-api-token

Удаляет API-токен по ID окончательно. После удаления токен больше не может аутентифицироваться.

Параметры
  • api_token_idnumberобязательный

    ID токена API.

delete-contact

Удаляет контакт навсегда по ID или email. Возвращает запись удаленного контакта, если она доступна.

Параметры
  • contact_identifierstringобязательный

    Контактный ID или email для удаления.

delete-contact-field

Безвозвратно удаляет определение поля контакта по ID.

Параметры
  • field_idnumberобязательный

    ID поля контакта для удаления.

delete-contact-list

Окончательно удаляет список контактов по ID.

Параметры
  • list_idnumberобязательный

    ID списка контактов для удаления.

delete-email-campaign

Удаляет email-кампанию по ID; удалить можно только кампанию в статусе draft.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты, которую нужно удалить.

delete-inbound-folder

Окончательно удаляет входящую папку вместе со всеми её почтовыми ящиками.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

delete-inbound-inbox

Навсегда удаляет входящий почтовый ящик.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

  • inbox_idnumberобязательный

    ID входящих.

delete-inbound-message

Окончательно удаляет входящее сообщение.

Параметры
  • inbox_idnumberобязательный

    ID входящих.

  • message_idstringобязательный

    Идентификатор сообщения.

delete-inbound-thread

Навсегда удаляет входящий тред.

Параметры
  • inbox_idnumberобязательный

    ID входящих.

  • thread_idstringобязательный

    Идентификатор потока.

delete-sandbox-inbox

Удаляет изолированный почтовый ящик и все его сообщения

Параметры
  • inbox_idnumber

    Устаревший псевдоним для sandbox_id в инструментах sandbox inbox.

  • sandbox_idnumber

    Предпочтительно. ID песочницы (тестового почтового ящика). В get-sandbox-inbox необязателен, если задан MAILTRAP_SANDBOX_ID.

delete-sandbox-message

Удаляет одно сообщение из песочницы

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

delete-sandbox-project

Удаляет sandbox-проект и все его инбоксы.

Параметры
  • project_idnumberобязательный

    ID проекта для удаления

delete-sending-domain

Удаляет домен отправки.

Параметры
  • sending_domain_idnumberобязательный

    Отправляем идентификатор домена для удаления.

delete-suppression

Удаляет подавление по ID. Mailtrap возобновит доставку на этот email, если он снова не будет подавлен.

Параметры
  • suppression_idstringобязательный

    ID подавления для удаления

delete-template

Удаляет существующий шаблон электронного письма.

Параметры
  • template_idnumberобязательный

    ID шаблона для удаления

delete-tracking-opt-out

Удалите email-адрес из списка отказа от отслеживания, чтобы отслеживание открытий и кликов снова применялось к нему.

Параметры
  • tracking_opt_out_idstringобязательный

    ID отказа от отслеживания для удаления

delete-webhook

Навсегда удаляет вебхук по идентификатору. Возвращает запись удалённого вебхука.

Параметры
  • webhook_idnumberобязательный

    ID вебхука для удаления

enable-sandbox-email-address

Включает адрес для приёма электронной почты для песочницы.

Параметры
  • sandbox_idnumberобязательный

    ID песочницы, над которой выполняется действие

forward-inbound-message

Пересылает входящее сообщение новым получателям (требуется хотя бы один to). Отправляет настоящее письмо.

Параметры
  • attachmentsobject[]

    Вложения файлов.

  • bccobject[]

    Необязательные получатели скрытой копии в виде объектов { email, name? } (также принимаются простые строки с email)

  • categorystring

    Категория сообщения.

  • ccobject[]

    Необязательные получатели копии (CC) в формате { email, name? } (также принимаются простые строки с email)

  • custom_variablesobject

    Пользовательские переменные.

  • fromobject

    Отправитель. Отклоняется для почтовых ящиков, размещённых на Mailtrap; обязателен для почтовых ящиков с пользовательским доменом.

  • headersobject

    Пользовательские заголовки.

  • htmlstring
  • inbox_idnumberобязательный

    ID входящих.

  • message_idstringобязательный

    Идентификатор сообщения для пересылки.

  • reply_toobject

    Обратный адрес.

  • textstring

    Тело в виде обычного текста.

  • toobject[]обязательный

    Получатели. По умолчанию используется исходный отправитель для ответа/ответа всем, если поле опущено; обязательно для пересылки.

forward-sandbox-message

Пересылает сообщение из песочницы на адрес электронной почты (учитывается в вашей ежемесячной квоте на пересылку)

Параметры
  • emailstringобязательный

    Email-адрес для пересылки сообщения

  • message_idnumberобязательный

    ID сообщения песочницы для пересылки.

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-api-tokenтолько чтение

Получает токен API по ID. Значение секретного токена НЕ возвращается здесь - только метаданные (имя, последние 4 цифры, ресурсы).

Параметры
  • api_token_idnumberобязательный

    ID токена API.

get-billing-usageтолько чтение

Получает текущее использование цикла выставления счетов для аккаунта (планы отправки и тестирования, лимиты и текущие значения).

Параметры

Без параметров.

get-company-infoтолько чтение

This appears to be a fragment or a truncated question rather than a complete inquiry. Could you please clarify what you'd like to know about getting company info for a sending domain in the context of domain compliance verification? For example, are you asking about: - How to implement such a lookup (e.g., via WHOIS, RDAP, SPF/DKIM records, or a compliance API)? - What information is typically returned (organization name, registration date, verification status)? - Which tools or services provide this data (e.g., Google Postmaster, Microsoft SNDS, third-party email compliance platforms)? - How to automate this check as part of a compliance workflow? Please provide a bit more detail, and I'll be happy to give a focused, practical answer.

Параметры
  • sending_domain_idintegerобязательный

    Отправка ID домена

get-contactтолько чтение

Получает контакт по ID или адресу электронной почты. Возвращает полную запись контакта, включая членство в списках, статус и пользовательские поля.

Параметры
  • contact_identifierstringобязательный

    ID контакта или адрес электронной почты.

get-contact-exportтолько чтение

Получает статус задания на экспорт контактов. Когда status равен finished, поле url содержит ссылку на скачивание.

Параметры
  • export_idnumberобязательный

    ID задания экспорта контактов для получения.

get-contact-fieldтолько чтение

Получает определение поля контакта по ID.

Параметры
  • field_idnumberобязательный

    ID поля контакта для получения.

get-contact-importтолько чтение

Получает статус задания на импорт контактов, включая количество созданных, обновлённых и превышающих лимит записей.

Параметры
  • import_idnumberобязательный

    ID задачи импорта контактов для получения.

get-contact-listтолько чтение

Получает список контактов по идентификатору.

Параметры
  • list_idnumberобязательный

    ID списка контактов для получения.

get-email-campaignтолько чтение

Получает email-кампанию по ID.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор email-кампании для получения.

get-email-campaign-statsтолько чтение

Получает сводную статистику производительности для email-кампании; опционально сужает окно с помощью start_date/end_date (YYYY-MM-DD).

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор email-кампании.

  • end_datestring

    Конец окна агрегации (включительно), в формате YYYY-MM-DD. По умолчанию — текущая дата.

  • start_datestring

    Начало окна агрегации (включительно) в формате YYYY-MM-DD. По умолчанию — день последнего запуска кампании.

get-email-log-messageтолько чтение

Получает одно сообщение журнала электронной почты по ID (UUID) для проверки статуса доставки и истории событий.

Параметры
  • include_contentboolean

    Если значение true, загружается исходное сообщение EML (если доступно) и включается разобранное содержимое HTML и текстового тела, по аналогии с show-sandbox-email-message.

  • message_idstringобязательный

    UUID сообщения журнала email (из ответа send или list-email-logs)

get-inbound-folderтолько чтение

Получает одну входящую папку по ID.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

get-inbound-inboxтолько чтение

Получает один входящий ящик по ID.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

  • inbox_idnumberобязательный

    ID входящих.

get-inbound-messageтолько чтение

Получает одно входящее сообщение с полным текстом и ссылками для скачивания вложений.

Параметры
  • inbox_idnumberобязательный

    ID входящих.

  • message_idstringобязательный

    Идентификатор сообщения.

get-inbound-threadтолько чтение

Получает одну входящую ветку с вложенными сообщениями (сначала самые старые).

Параметры
  • inbox_idnumberобязательный

    ID входящих.

  • thread_idstringобязательный

    Идентификатор потока.

get-permission-resourcesтолько чтение

Получает все ресурсы (входящие, проекты, домены, биллинг, аккаунт), к которым у API-токена есть доступ администратора, сгруппированные по иерархии.

Параметры

Без параметров.

get-sandbox-attachmentтолько чтение

Получает метаданные и URL для скачивания одного вложения песочницы.

Параметры
  • attachment_idnumberобязательный

    ID вложения для получения

  • message_idnumberобязательный

    ID сообщения песочницы, содержащего вложение

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-inboxтолько чтение

Получает подробности почтового ящика песочницы, включая SMTP-учётные данные, количество писем и статус.

Параметры
  • inbox_idnumber

    Устаревший псевдоним для sandbox_id в инструментах sandbox inbox.

  • sandbox_idnumber

    Предпочтительный. ID песочницы (тестового входящего ящика). Для get-sandbox-inbox необязателен, если задан MAILTRAP_SANDBOX_ID.

get-sandbox-message-emlтолько чтение

Получает сообщение из песочницы в виде полезной нагрузки EML-файла.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-headersтолько чтение

Получает разобранные заголовки почты для сообщения песочницы.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-htmlтолько чтение

Получает отрисованный HTML-код сообщения в sandbox.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-html-analysisтолько чтение

Получает анализ HTML для сообщения в песочнице (совместимость с клиентами, проблемные элементы).

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-html-sourceтолько чтение

Получает необработанный HTML-код сообщения в песочнице.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-rawтолько чтение

Получает сырое сообщение (в формате MIME) для сообщения в песочнице.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-messagesтолько чтение

Получает список сообщений из тестового почтового ящика sandbox.

Параметры
  • last_idnumber

    Пагинация с использованием ID последнего сообщения. Возвращает сообщения после указанного ID сообщения.

  • pagenumber

    Номер страницы для пагинации.

  • sandbox_idnumber

    Предпочтительный. ID песочницы Mailtrap (тестового ящика). Необязательно, если задана переменная окружения MAILTRAP_SANDBOX_ID.

  • searchstring

    Поисковый запрос для фильтрации сообщений

  • test_inbox_idnumber

    Устаревший псевдоним для sandbox_id. Используется, когда sandbox_id не указан.

get-sandbox-message-spam-scoreтолько чтение

Получает отчёт о спаме SpamAssassin для тестового сообщения (оценка, правила, отчёт).

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-message-textтолько чтение

Получает тело в формате обычного текста сообщения песочницы.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

get-sandbox-projectтолько чтение

Получает sandbox-проект по ID, включая его входящие папки и количество писем.

Параметры
  • project_idnumberобязательный

    ID проекта для получения

get-sending-domainтолько чтение

Получает отправляющий домен по ID и его статус проверки. Опционально включает инструкции по настройке DNS с помощью параметра include_setup_instructions.

Параметры
  • include_setup_instructionsboolean

    Если это верно, добавь инструкции по настройке DNS в ответ.

  • sending_domain_idnumberобязательный

    Отправка ID домена

get-sending-statsтолько чтение

Получает статистику отправки email (показатели доставки, возвратов, открытий, кликов и спама) за указанный период. Опционально разбивает по домену, категории, поставщику услуг email или дате.

Параметры
  • breakdownenum

    Как разбить статистику: агрегированная (по умолчанию), по домену (by_domain), по категории (by_category), по поставщику электронной почты (by_email_service_provider) или по дате (by_date)

  • categoriesstring[]

    Необязательный фильтр: ограничить этими категориями писем.

  • email_service_providersstring[]

    Необязательный фильтр: ограничьте этими поставщиками электронной почты (например, Google, Yahoo, Outlook).

  • end_datestringобязательный

    Конечная дата для диапазона статистики (ГГГГ-ММ-ДД)

  • sending_domain_idsinteger[]

    Необязательный фильтр: ограничить указанными ID доменов-отправителей.

  • sending_streamsenum[]

    Необязательный фильтр: ограничить транзакционным и/или пакетным потоком

  • start_datestringобязательный

    Начальная дата для диапазона статистики (ГГГГ-ММ-ДД)

get-templateтолько чтение

Получает один шаблон email по идентификатору, включая тему, категорию и HTML/текстовое тело.

Параметры
  • template_idnumberобязательный

    ID шаблона для получения

get-webhookтолько чтение

Получает один вебхук по ID.

Параметры
  • webhook_idnumberобязательный

    Идентификатор вебхука для получения.

list-account-accessesтолько чтение

Перечисляет доступы к аккаунту (пользователи, приглашения, токены API). Опционально ограничивает по UUID доменов, inbox IDs или project IDs. Требует прав администратора/владельца аккаунта.

Параметры
  • domain_uuidsstring[]

    Optional: фильтровать по UUID доменов отправки.

  • inbox_idsstring[]

    Необязательно: фильтровать по ID входящих сообщений песочницы.

  • project_idsstring[]

    Необязательно: фильтруйте по идентификаторам проектов песочницы.

list-accountsтолько чтение

Перечисляет учетные записи Mailtrap, доступные для токена API, с уровнями доступа каждой учетной записи.

Параметры

Без параметров.

list-api-tokensтолько чтение

Выводит список всех API-токенов для учётной записи.

Параметры

Без параметров.

list-contact-fieldsтолько чтение

Выводит список всех определений полей контакта для учётной записи.

Параметры

Без параметров.

list-contact-listsтолько чтение

Выводит все списки контактов для аккаунта. Опционально фильтрует по имени с помощью search (сопоставление без учёта регистра).

Параметры
  • searchstring

    Фильтрует списки контактов по имени (без учёта регистра), например, «news».

list-email-campaignsтолько чтение

Получает список email-кампаний аккаунта, сначала новые, с пагинацией на основе токена страницы (token, per_page). Опционально фильтрует по имени с помощью search.

Параметры
  • per_pageinteger

    Количество кампаний на странице. По умолчанию — 50, максимум — 100.

  • searchstring

    Фильтруй кампании по названию (без учёта регистра, частичное совпадение), например, "spring".

  • tokeninteger

    Номер страницы для получения (пагинация по токену страницы). По умолчанию — 1.

list-email-logsтолько чтение

Выводит список журналов отправленных писем (история доставки) с опциональной постраничной разбивкой и фильтрами; используйте для отладки проблем с доставкой.

Параметры
  • categorystring | string[]

    Фильтруй по категории email. Используй с category_operator. Одно значение, массив (например, ["Newsletter", "Alert"]) или строка через запятую (например, "Newsletter,Alert") для нескольких (OR).

  • category_operatorenum

    Оператор для категории. По умолчанию: равно.

  • clicks_countnumber

    Фильтруйте по количеству кликов по ссылкам. Используйте вместе с clicks_count_operator.

  • clicks_count_operatorenum

    Оператор для clicks_count. По умолчанию: равно.

  • client_ipstring

    Фильтруйте по IP-адресу клиента. Используйте с client_ip_operator.

  • client_ip_operatorenum

    Оператор для client_ip. По умолчанию: equal.

  • email_service_providerstring | string[]

    Фильтруйте по почтовому провайдеру (точное совпадение). Одно значение или массив. Используйте с *_operator.

  • email_service_provider_operatorenum

    Оператор для email_service_provider. По умолчанию: equal.

  • email_service_provider_responsestring | string[]

    Фильтр по тексту ответа провайдера. Одиночное значение или массив. Используйте с *_operator.

  • email_service_provider_response_operatorenum

    Оператор для email_service_provider_response. По умолчанию: ci_contain.

  • eventsenum | enum[]

    Фильтрует по типу событий. Используется с events_operator: include_event или not_include_event.

  • events_operatorenum

    Оператор для фильтра событий. По умолчанию: include_event.

  • from_emailstring | string[]

    Фильтровать по email отправителя (используйте с from_operator). Одно значение или массив.

  • from_operatorenum

    Оператор для фильтра from_email. По умолчанию: ci_equal. ci_contain/ci_not_contain сопоставляют подстроку; ci_equal/ci_not_equal сопоставляют точно (без учёта регистра).

  • opens_countnumber

    Фильтруйте по количеству открытий. Используйте с opens_count_operator.

  • opens_count_operatorenum

    Оператор для opens_count. По умолчанию: равенство.

  • recipient_mxstring | string[]

    Фильтр по MX получателя. Одно значение или массив. Используйте с recipient_mx_operator.

  • recipient_mx_operatorenum

    Оператор для recipient_mx. По умолчанию: ci_contain.

  • search_afterstring

    Курсор пагинации из next_page_cursor предыдущего ответа позволяет получить следующую страницу.

  • sending_domain_idnumber | number[]

    Фильтр по ID отправляющего домена. Одиночное значение или массив. Найдите ID в Mailtrap Sending Domains.

  • sending_domain_id_operatorenum

    Оператор для фильтра sending_domain_id. По умолчанию: равно.

  • sending_ipstring

    Фильтрует по IP отправителя. Используется с sending_ip_operator.

  • sending_ip_operatorenum

    Оператор для sending_ip. По умолчанию: равно.

  • sending_streamenum | enum[]

    Фильтр по потоку отправки: транзакционный или массовый. Одиночное значение или массив.

  • sending_stream_operatorenum

    Оператор для фильтра sending_stream. По умолчанию: равно.

  • sent_afterstring

    Дата/время в формате ISO 8601; возвращает только логи писем, отправленных после этого времени.

  • sent_beforestring

    ISO 8601 дата/время; возвращать только логи для электронных писем, отправленных до этого времени.

  • statusenum | enum[]

    Фильтровать по статусу доставки (используйте с status_operator). Одно значение или массив.

  • status_operatorenum

    Оператор для фильтра статуса. По умолчанию: равно.

  • subjectstring | string[]

    Фильтруйте по теме письма (используйте с subject_operator). Одно значение или массив. Опустите для empty/not_empty.

  • subject_operatorenum

    Оператор для фильтра по subject. По умолчанию: ci_contain. Используйте empty/not_empty для фильтрации по наличию subject.

  • to_emailstring | string[]

    Фильтр по email получателя (используйте с to_operator). Одно значение или массив.

  • to_operatorenum

    Оператор для фильтра to_email. По умолчанию: ci_equal.

list-inbound-foldersтолько чтение

Перечисли все входящие папки в аккаунте.

Параметры

Без параметров.

list-inbound-inboxesтолько чтение

Перечисляет все входящие папки в папке входящих.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки, для которой нужно получить список входящих.

list-inbound-messagesтолько чтение

Выводит список полученных сообщений во входящей папке (с постраничной разбивкой). Передайте last_id из предыдущего ответа, чтобы получить следующую страницу.

Параметры
  • inbox_idnumberобязательный

    Идентификатор входящих для вывода списка сообщений.

  • last_idstring

    Курсор пагинации из last_id предыдущего ответа.

list-inbound-threadsтолько чтение

Перечисляет ветки разговоров во входящем ящике (постранично). Передайте last_id из предыдущего ответа, чтобы получить следующую страницу.

Параметры
  • inbox_idnumberобязательный

    Идентификатор входящих, для которого нужно получить список обсуждений.

  • last_idstring

    Курсор пагинации из last_id предыдущего ответа.

list-sandbox-attachmentsтолько чтение

Выводит список всех вложений в сообщении песочницы.

Параметры
  • message_idnumberобязательный

    ID сообщения песочницы

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

list-sandboxesтолько чтение

Выводит список всех песочниц, доступных API-токену, во всех проектах.

Параметры

Без параметров.

list-sandbox-projectsтолько чтение

Выводит список всех sandbox-проектов и их почтовых ящиков в вашей учётной записи Mailtrap.

Параметры

Без параметров.

list-sending-domainsтолько чтение

Перечисляет домены отправки и их статус проверки DNS.

Параметры

Без параметров.

list-sub-accountsтолько чтение

Выводит список субаккаунтов в организации. Требует переменную окружения MAILTRAP_ORGANIZATION_ID и разрешения на управление субаккаунтами.

Параметры

Без параметров.

list-suppressionsтолько чтение

Перечисляет или ищет подавления. Опционально фильтрует по email. Возвращает до 1000 подавлений за один вызов.

Параметры
  • emailstring

    Необязательный фильтр по электронной почте. Возвращает подавления, соответствующие этому адресу.

list-templatesтолько чтение

Выводит список email-шаблонов аккаунта с пагинацией по токену страницы (token, per_page). Страницы - это смещения по списку, отсортированному от новых к старым, поэтому после удаления шаблонов выводите список заново с токена 1, а не продолжайте со следующего токена.

Параметры
  • per_pageinteger

    Количество шаблонов на странице. По умолчанию 50, максимум 100. Передаёт одно и то же значение на каждой странице.

  • tokeninteger

    Номер страницы для получения (пагинация по токену страницы). По умолчанию — 1.

list-tracking-opt-outsтолько чтение

Перечисляет email-адреса, исключенные из отслеживания открытий и кликов. Возвращает до 1000 записей за вызов.

Параметры
  • emailstring

    Необязательный фильтр по email. Возвращает отказы от отслеживания, соответствующие этому адресу.

  • end_timestring

    Только opt-outs, созданные не позднее указанного времени (ISO 8601, например, 2026-08-31T23:59:59Z).

  • last_idstring

    Курсор пагинации: last_id из предыдущего ответа для получения следующей страницы.

  • start_timestring

    Только отказы, созданные в указанное время или после него (ISO 8601, например, 2026-08-01T00:00:00Z).

list-webhooksтолько чтение

Перечисляет все вебхуки для аккаунта.

Параметры

Без параметров.

mark-sandbox-as-read

Отмечает все сообщения в песочнице как прочитанные.

Параметры
  • sandbox_idnumberобязательный

    ID песочницы, над которой выполняется действие

remove-account-access

Удаляет доступ к аккаунту по ID. Для User specifiers отзывает разрешения; для Invite или ApiToken specifiers удаляет сам specifier. Требует прав администратора/владельца.

Параметры
  • account_access_idnumberобязательный

    ID доступа к аккаунту для удаления.

reply-all-to-inbound-message

Отвечает на входящее сообщение и копирует остальных получателей оригинала. Отправляет реальное письмо.

Параметры
  • attachmentsobject[]

    Вложения файлов.

  • bccobject[]

    Необязательные получатели скрытой копии в виде объектов { email, name? } (также принимаются простые строки с email)

  • categorystring

    Категория сообщения.

  • ccobject[]

    Необязательные получатели копии (CC) в формате { email, name? } (также принимаются простые строки с email)

  • custom_variablesobject

    Пользовательские переменные.

  • fromobject

    Отправитель. Отклоняется для почтовых ящиков, размещённых на Mailtrap; обязателен для почтовых ящиков с пользовательским доменом.

  • headersobject

    Пользовательские заголовки.

  • htmlstring
  • inbox_idnumberобязательный

    ID входящих.

  • message_idstringобязательный

    Идентификатор сообщения, на которое нужно ответить.

  • reply_toobject

    Обратный адрес.

  • textstring

    Тело в виде обычного текста.

  • toobject[]

    Получатели. По умолчанию используется исходный отправитель для ответа/ответа всем, если поле опущено; обязательно для пересылки.

reply-to-inbound-message

Отвечает на входящее сообщение (отправляет исходному отправителю). Отправляет реальное электронное письмо.

Параметры
  • attachmentsobject[]

    Вложения файлов.

  • bccobject[]

    Необязательные получатели скрытой копии в виде объектов { email, name? } (также принимаются простые строки с email)

  • categorystring

    Категория сообщения.

  • ccobject[]

    Необязательные получатели копии (CC) в формате { email, name? } (также принимаются простые строки с email)

  • custom_variablesobject

    Пользовательские переменные.

  • fromobject

    Отправитель. Отклоняется для почтовых ящиков, размещённых на Mailtrap; обязателен для почтовых ящиков с пользовательским доменом.

  • headersobject

    Пользовательские заголовки.

  • htmlstring
  • inbox_idnumberобязательный

    ID входящих.

  • message_idstringобязательный

    Идентификатор сообщения, на которое нужно ответить.

  • reply_toobject

    Обратный адрес.

  • textstring

    Тело в виде обычного текста.

  • toobject[]

    Получатели. По умолчанию используется исходный отправитель для ответа/ответа всем, если поле опущено; обязательно для пересылки.

reset-api-token

Сбрасывает (обновляет) токен API по идентификатору. Ответ включает новое секретное значение token, которое возвращается только при этом вызове — сохраните его немедленно. Предыдущий токен аннулируется.

Параметры
  • api_token_idnumberобязательный

    ID токена API.

  • expires_atstring | null

    Необязательный срок действия нового токена указывается как дата-время в формате ISO 8601 (например, 2027-06-01T00:00:00Z). Если не указано, используется серверное значение по умолчанию (1 год). Для токена, который никогда не истекает, передайте явное значение null. Значения в прошлом или более чем на 5 лет вперед отклоняются с ошибкой 422.

reset-email-campaign

Сбрасывает scheduled email-кампанию обратно в draft; сбросить можно только scheduled кампании.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты для сброса.

reset-sandbox-credentials

Сбрасывает учетные данные SMTP для sandbox

Параметры
  • sandbox_idnumberобязательный

    ID песочницы, над которой выполняется действие

reset-sandbox-email-address

Создает новый адрес электронной почты для приема писем в песочнице.

Параметры
  • sandbox_idnumberобязательный

    ID песочницы, над которой выполняется действие

schedule-email-campaign

Планирует рассылку draft email-кампании с началом отправки в datetime (ISO 8601, момент времени должен быть в будущем и не более чем на 1 месяц вперёд); запланировать можно только кампании со статусом draft.

Параметры
  • datetimestringобязательный

    Когда отправлять кампанию (ISO 8601, например 2026-09-01T09:00:00Z или со смещением относительно UTC). Должно быть в будущем и не более чем на 1 месяц вперед, иначе запрос отклоняется с кодом 422.

  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты для планирования.

send-email

Отправляет электронное письмо на ваш адрес получателя с помощью Mailtrap Email API. Вы можете отправлять письма сразу нескольким получателям.

Параметры
  • bccobject[]

    Необязательные получатели скрытой копии в виде объектов { email, name? } (также принимаются простые строки с email)

  • categorystring

    Необязательная категория электронной почты для отслеживания. Её нужно опустить, когда задан template_uuid.

  • ccobject[]

    Необязательные получатели копии (CC) в формате { email, name? } (также принимаются простые строки с email)

  • fromobject

    Отправитель в виде { email, name? } (также принимается строка с email). Можно опустить, если задан DEFAULT_FROM_EMAIL.

  • htmlstring

    Необязательная HTML-версия тела письма. Её нужно опускать, когда установлен template_uuid.

  • subjectstring

    Тема письма. Обязательна для встроенных (text/html) отправок; должна быть опущена, когда установлен template_uuid.

  • template_uuidstring

    Используйте шаблон письма Mailtrap вместо встроенного содержимого. Если шаблон задан, поля subject, text, html и category должны быть опущены (согласно API Mailtrap).

  • template_variablesobject

    Переменные, подставляемые в шаблон, на который ссылается template_uuid. Разрешены только вместе с template_uuid; в противном случае отклоняются.

  • textstring

    Текст тела письма. Обязателен (наряду с html или вместо него) для inline-отправок; должен быть опущен, если задан template_uuid.

  • toobject[]

    Получатели в виде массива объектов { email, name? } (допускаются также просто строки с email-адресами). Поле необязательно, если указаны cc или bcc; при этом хотя бы одно из полей to/cc/bcc должно содержать получателя.

send-sandbox-email

Отправляет электронное письмо в режиме песочницы в тестовый почтовый ящик без доставки вашим получателям.

Параметры
  • bccobject[]

    Необязательные получатели скрытой копии в виде объектов { email, name? } (также принимаются простые строки с email)

  • categorystring

    Необязательная категория электронной почты для отслеживания. Её нужно опустить, когда задан template_uuid.

  • ccobject[]

    Необязательные получатели копии (CC) в формате { email, name? } (также принимаются простые строки с email)

  • fromobject

    Отправитель в виде { email, name? } (также принимается строка с email). Можно опустить, если задан DEFAULT_FROM_EMAIL.

  • htmlstring

    Необязательная HTML-версия тела письма. Её нужно опускать, когда установлен template_uuid.

  • sandbox_idnumber

    Предпочтительно. ID песочницы Mailtrap (тестового ящика). Необязательно, если задана переменная окружения MAILTRAP_SANDBOX_ID.

  • subjectstring

    Тема письма. Обязательна для встроенных (text/html) отправок; должна быть опущена, когда установлен template_uuid.

  • template_uuidstring

    Используйте шаблон письма Mailtrap вместо встроенного содержимого. Если шаблон задан, поля subject, text, html и category должны быть опущены (согласно API Mailtrap).

  • template_variablesobject

    Переменные, подставляемые в шаблон, на который ссылается template_uuid. Разрешены только вместе с template_uuid; в противном случае отклоняются.

  • test_inbox_idnumber

    Устаревший псевдоним для sandbox_id. Используется, когда sandbox_id не указан.

  • textstring

    Текст тела письма. Обязателен (наряду с html или вместо него) для inline-отправок; должен быть опущен, если задан template_uuid.

  • toobject[]

    Получатели как массив объектов { email, name? } (простые строки с email в качестве элементов или строка с email, разделёнными запятыми, также принимаются). Необязательно, если указаны cc или bcc; по крайней мере одно из полей to/cc/bcc должно содержать получателя.

send-sending-domain-setup-instructions

Инструкции по настройке DNS для отправляющего домена на заданный адрес.

Параметры
  • emailstringобязательный

    Адрес электронной почты для отправки инструкций по настройке DNS

  • sending_domain_idnumberобязательный

    Отправка ID домена

show-sandbox-email-messageтолько чтение

Показывает детали и содержимое письма из тестового почтового ящика sandbox. Опционально включает отчёт о спаме (оценка SpamAssassin) и HTML-анализ (совместимость с клиентами) для рабочих процессов тестирования электронной почты.

Параметры
  • include_html_analysisboolean

    Когда значение true, включает анализ HTML (совместимость с клиентами, проблемные элементы). Критически важно для тестирования почтовых клиентов.

  • include_spam_reportboolean

    Когда параметр true, включается отчёт о спаме (оценка и детали SpamAssassin). Критически важно для тестирования доставляемости.

  • message_idnumberобязательный

    Идентификатор сообщения электронной почты в песочнице для получения.

  • sandbox_idnumber

    Предпочтительно. ID песочницы Mailtrap (тестового ящика). Необязательно, если задана переменная окружения MAILTRAP_SANDBOX_ID.

  • test_inbox_idnumber

    Устаревший псевдоним для sandbox_id. Используется, когда sandbox_id не указан.

start-email-campaign

Начинает отправку черновика email-кампании немедленно; запускать можно только черновики кампаний.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор email-кампании для запуска.

terminate-email-campaign

Прерывает email-кампанию, которая в данный момент выполняется (статусы started, queued или paused), прекращая текущую отправку.

Параметры
  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты, которую необходимо завершить.

update-company-info

Обновите информацию о компании отправляющего домена.

Параметры
  • addressstring

    Уличный адрес.

  • citystring

    Город

  • countrystring

    Страна

  • info_levelenum

    Является ли отправитель юридическим лицом или частным лицом.

  • namestring

    Название компании или имя физического лица.

  • phonestring

    Номер телефона.

  • privacy_policy_urlstring

    URL страницы политики конфиденциальности.

  • sending_domain_idintegerобязательный

    Отправка ID домена

  • terms_of_service_urlstring

    URL страницы с условиями использования.

  • website_urlstring

    URL сайта компании

  • zip_codestring

    Почтовый индекс.

update-contact

Обновляет контакт (по ID или email). list_ids заменяет набор членства; list_ids_included/list_ids_excluded добавляют/удаляют, не затрагивая остальное.

Параметры
  • contact_identifierstringобязательный

    ID контакта или email для обновления.

  • emailstring

    Новый адрес электронной почты для контакта.

  • fieldsobject

    Значения настраиваемых полей для установки, сгруппированные по merge-тегам. Допустимые типы значений — строка, число или булево значение.

  • list_idsnumber[]

    Замените членство контакта в списках на этот точный набор идентификаторов списков.

  • list_ids_excludednumber[]

    Перечислите идентификаторы, из которых нужно удалить контакт.

  • list_ids_includednumber[]

    Перечислите идентификаторы для добавления контакта (аддитивно).

  • unsubscribedboolean

    Переместите контакт в статус unsubscribed (true) или subscribed (false).

update-contact-field

Обновляет определение поля контакта. Можно изменить любую комбинацию name, merge_tag или data_type.

Параметры
  • data_typeenum

    Новый тип данных для поля.

  • field_idnumberобязательный

    Идентификатор поля контакта для обновления.

  • merge_tagstring

    Это новый merge tag для поля. Он должен быть уникальным.

  • namestring

    Новое отображаемое имя для поля.

update-contact-list

Переименовывает существующий список контактов.

Параметры
  • list_idnumberобязательный

    ID списка контактов для обновления.

  • namestringобязательный

    Вот несколько вариантов названия для списка контактов, в зависимости от контекста и tone of voice продукта: Нейтральные и понятные: - Контакты - Люди - Адресная книга Более тёплые и личные: - Мои люди - Круг общения - Близкие Акцент на связях и сети: - Связи - Моя сеть - Знакомства Короткие, для мобильных интерфейсов: - Контакт-лист (калька с английского, но встречается) - Люди рядом - Телефонная книга Если хочется уйти от бытового «контактов» в сторону действий: - Мои собеседники - Адресаты Какой вариант ближе — зависит от того, какой продукт: мессенджер, CRM, телефонная книга или соцсеть. Если скажете контекст, сузим точнее.

update-email-campaign

Обновляет email-кампанию в статусе «черновик»; изменяются только указанные поля, а кампании в любом другом статусе обновить нельзя.

Параметры
  • contact_list_idsinteger[]

    Идентификаторы списков контактов для отправки. Рассматриваются как полный набор включенных списков — списки, не перечисленные, удаляются.

  • contact_segment_idsinteger[]

    Идентификаторы сегментов контактов, на которые отправляется сообщение. Рассматриваются как полный набор включённых сегментов.

  • delivery_modeenum

    Как доставляется кампания. rapid отправляет как можно быстрее; gradual ограничивает отправку до delivery_options.emails_per_hour.

  • delivery_optionsobject

    Варианты ограничения доставки. Применяется, когда delivery_mode имеет значение gradual.

  • domain_idinteger

    Идентификатор подтвержденного домена отправителя, используемого для кампании, возвращаемый конечными точками Sending Domains.

  • email_campaign_idintegerобязательный

    Уникальный идентификатор кампании электронной почты для обновления.

  • from_display_namestring

    Отображаемое имя в заголовке From.

  • from_local_partstring

    Локальная часть (перед @) адреса From.

  • namestring

    Название кампании

  • reply_toobject

    Части адреса Reply-To.

  • template_attributesobject

    Инлайн email-шаблон — шаблон кампании редактируется на месте. Обновления частичные: изменяются только те подполя, которые вы передаёте.

update-inbound-folder

Переименовывает входящую папку.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

  • namestringобязательный

    Новое имя папки.

update-inbound-inbox

Переименовывает входящий почтовый ящик.

Параметры
  • folder_idnumberобязательный

    Идентификатор входящей папки.

  • inbox_idnumberобязательный

    ID входящих.

  • namestringобязательный

    Новое имя входящих.

update-sandbox-inbox

Обновляет имя песочницы почтового ящика или имя пользователя электронной почты.

Параметры
  • email_usernamestring

    Новое имя пользователя для входящей почты.

  • inbox_idnumber

    Устаревший псевдоним для sandbox_id в инструментах sandbox inbox.

  • namestring

    Новое название для входящих

  • sandbox_idnumber

    Предпочтительный. ID песочницы (тестового входящего ящика). Для get-sandbox-inbox необязателен, если задан MAILTRAP_SANDBOX_ID.

update-sandbox-message

Отмечает сообщение песочницы как прочитанное или непрочитанное.

Параметры
  • is_readbooleanобязательный

    Отмечает сообщение как прочитанное (true) или непрочитанное (false).

  • message_idnumberобязательный

    ID сообщения в песочнице для обновления

  • sandbox_idnumber

    ID песочницы Mailtrap (тестового ящика). Необязателен, если задана переменная окружения MAILTRAP_SANDBOX_ID.

update-sandbox-project

Переименовывает существующий проект песочницы

Параметры
  • namestringобязательный

    Новое название проекта (2–100 символов)

  • project_idnumberобязательный

    ID проекта для обновления

update-sending-domain

Обновляет настройки отслеживания и входящих сообщений для отправляющего домена.

Параметры
  • auto_unsubscribe_link_enabledboolean

    Автоматически добавляет ссылку для отмены подписки в электронные письма.

  • click_tracking_enabledboolean

    Отслеживает клики по ссылкам в письмах, отправленных с этого домена.

  • inbound_enabledboolean

    Разрешает привязывать домен к входящему почтовому ящику как перехватывающий все адреса (catch-all).

  • open_tracking_enabledboolean

    Отслеживает открытия писем, отправленных с этого домена.

  • sending_domain_idintegerобязательный

    Отправка ID домена

  • tracking_opt_out_enabledboolean

    Добавьте ссылку для отказа от отслеживания в отслеживаемые письма. Требуется отслеживание открытий или кликов.

update-template

Обновляет существующий шаблон электронного письма.

Параметры
  • categorystring

    Категория: Описание библиотеки (Library description) Входной текст: The library reads configuration files in YAML format and automatically merges them with environment variables. It supports nested keys and provides a simple API to access values. You can also override settings at runtime. Перевод: Библиотека читает конфигурационные файлы в формате YAML и автоматически объединяет их с переменными окружения. Она поддерживает вложенные ключи и даёт простой API для доступа к значениям. Настройки можно переопределить и во время выполнения.

  • htmlstring

    Новое HTML-содержимое шаблона

  • namestring

    Новое имя шаблона.

  • subjectstring

    Новая тема письма

  • template_idnumberобязательный

    ID шаблона для обновления

  • textstring

    # Шаблон перевода (простая текстовая версия) ## Входной текст (вставьте сюда текст для перевода) --- ## Правила перевода ### Запрещено - Длинное тире «—» — используйте дефис «-», запятую, двоеточие или точку. - Канцелярит и отглагольные существительные вместо глаголов: «осуществление оптимизации» → «ускоряет». - Обороты-кальки: «данный», «является», «представляет собой», «стоит отметить», «важно понимать», «в современном мире», «играет ключевую роль», «позволяет осуществить», «обеспечивает возможность». - Негативные параллелизмы: «не просто X, а Y», «не только X, но и Y». - Формульные выводы: «таким образом», «подводя итог». - Раздувание значимости: «мощный инструмент», «открывает новые горизонты», «выводит на новый уровень». - Модальное хеджирование в каждом предложении: «может стать», «способен обеспечить», «призван решить». ### Требования - Начинайте сразу с сути, без вступлений и разгона. - Больше глаголов, меньше существительных. - Конкретика вместо общих слов: что именно делает объект и кому это полезно. - Живой, разговорный, но не панибратский тон — как будто толковый разработчик коротко объясняет коллеге. --- ## Примеры Входной текст: Retrieves and queries up-to-date documentation and code examples from Context7 for any programming library or framework. You must call 'Resolve Context7 Library ID' tool first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query. Do not call this tool more than 3 times per question. Перевод: Получает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса. --- Входной текст: Convert a resource described by an http:, https:, file: or data: URI to markdown Перевод: Преобразует ресурс, заданный URI вида http:, https:, file: или data:, в Markdown.

update-webhook

Обновляет изменяемые поля вебхука (url, active, payload_format, event_types, inbound_inbox_id). Поля webhook_type, sending_stream и domain_id нельзя изменить после создания.

Параметры
  • activeboolean

    Включить или отключить вебхук.

  • event_typesenum[]

    События для подписки. Применяется только к вебхукам email_sending.

  • inbound_inbox_idnumber

    ID входящего почтового ящика, к которому привязан вебхук. Применимо только для вебхуков inbound_receiving.

  • payload_formatenum

    Кодирование полезной нагрузки.

  • urlstring

    Новый URL, на который Mailtrap будет отправлять события вебхуков.

  • webhook_idnumberобязательный

    Идентификатор вебхука, который нужно обновить.

0.10.0основная
0.9.0
0.8.0
0.7.0
0.6.0
0.5.0
0.4.3
0.4.2
0.4.1
0.4.0
0.3.0
0.2.0
0.1.0
0.0.5
0.0.4
0.0.3
0.0.2
0.0.1

Выберите клиент, чтобы установить railsware/mailtrap-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "railsware-mailtrap-mcp-dty7": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"railsware-mailtrap-mcp-dty7\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-mailtrap\"],\"env\":{\"MAILTRAP_API_TOKEN\":\"${input:mailtrapApiToken}\",\"DEFAULT_FROM_EMAIL\":\"${input:senderEmail}\",\"MAILTRAP_ACCOUNT_ID\":\"${input:mailtrapAccountId}\",\"MAILTRAP_TEST_INBOX_ID\":\"${input:mailtrapTestInboxId}\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add railsware-mailtrap-mcp-dty7 --env MAILTRAP_API_TOKEN=${input:mailtrapApiToken} --env DEFAULT_FROM_EMAIL=${input:senderEmail} --env MAILTRAP_ACCOUNT_ID=${input:mailtrapAccountId} --env MAILTRAP_TEST_INBOX_ID=${input:mailtrapTestInboxId} -- npx -y mcp-mailtrap

Либо через JSON-конфиг:

claude mcp add-json railsware-mailtrap-mcp-dty7 "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-mailtrap\"],\"env\":{\"MAILTRAP_API_TOKEN\":\"${input:mailtrapApiToken}\",\"DEFAULT_FROM_EMAIL\":\"${input:senderEmail}\",\"MAILTRAP_ACCOUNT_ID\":\"${input:mailtrapAccountId}\",\"MAILTRAP_TEST_INBOX_ID\":\"${input:mailtrapTestInboxId}\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add railsware-mailtrap-mcp-dty7 --env MAILTRAP_API_TOKEN=${input:mailtrapApiToken} --env DEFAULT_FROM_EMAIL=${input:senderEmail} --env MAILTRAP_ACCOUNT_ID=${input:mailtrapAccountId} --env MAILTRAP_TEST_INBOX_ID=${input:mailtrapTestInboxId} -- npx -y mcp-mailtrap

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.railsware-mailtrap-mcp-dty7]
command = "npx"
args = ["-y", "mcp-mailtrap"]

[mcp_servers.railsware-mailtrap-mcp-dty7.env]
MAILTRAP_API_TOKEN = "${input:mailtrapApiToken}"
DEFAULT_FROM_EMAIL = "${input:senderEmail}"
MAILTRAP_ACCOUNT_ID = "${input:mailtrapAccountId}"
MAILTRAP_TEST_INBOX_ID = "${input:mailtrapTestInboxId}"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите railsware/mailtrap-mcp, а в поле команды запуска — строку ниже:
npx -y mcp-mailtrap

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например railsware-mailtrap-mcp-dty7.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: railsware-mailtrap-mcp-dty7
    command: npx
    args:
      - "-y"
      - "mcp-mailtrap"
    env:
      MAILTRAP_API_TOKEN: ${input:mailtrapApiToken}
      DEFAULT_FROM_EMAIL: ${input:senderEmail}
      MAILTRAP_ACCOUNT_ID: ${input:mailtrapAccountId}
      MAILTRAP_TEST_INBOX_ID: ${input:mailtrapTestInboxId}
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "railsware-mailtrap-mcp-dty7": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mailtrap"
      ],
      "env": {
        "MAILTRAP_API_TOKEN": "${input:mailtrapApiToken}",
        "DEFAULT_FROM_EMAIL": "${input:senderEmail}",
        "MAILTRAP_ACCOUNT_ID": "${input:mailtrapAccountId}",
        "MAILTRAP_TEST_INBOX_ID": "${input:mailtrapTestInboxId}"
      }
    }
  }
}

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

shy2593666979/mcp-server-email

shy2593666979/mcp-server-email

от shy2593666979

MCP сервер для отправки email и поиска вложений. Даёт AI-ассистентам возможность составлять и отправлять письма с вложениями, а также искать файлы по шаблону. Использует SMTP, поддерживает нескольких получателей.

Python⭐ 81
cseguinlz/doubletick-cli

cseguinlz/doubletick-cli

от cseguinlz

MCP-сервер для отслеживания прочтения писем через Gmail. Отправляйте трекинг-письма из терминала или через AI-агентов - узнавайте, когда их открыли. Полезен разработчикам для контроля доставки.

JavaScript⭐ 2
Resend MCP

Resend MCP

официальный

от resend

Отправляет и получает письма через Resend, управляет контактами, рассылками и доменами. Есть облачная версия без установки.

TypeScript⭐ 576
codefuturist/email-mcp

codefuturist/email-mcp

от codefuturist

MCP сервер для email: читает, отправляет, планирует и анализирует письма через IMAP и SMTP. Сервер поддерживает несколько аккаунтов, OAuth2 и real-time мониторинг. Полезен для подключения почты к AI-ассистентам.

TypeScript⭐ 133
helbertparanhos/resend-email-mcp

helbertparanhos/resend-email-mcp

от helbertparanhos

MCP-сервер с полным покрытием Resend API: отправка и управление email, доменами, контактами, рассылками и шаблонами. Уникальный слой диагностики для анализа доставляемости, DNS-проблем, баунсов и а...

TypeScript⭐ 1
multimail-dev/mcp-server

multimail-dev/mcp-server

от multimail-dev

MultiMail — MCP сервер, дающий агенту email с доверительной лестницей от read-only до полной автономии. Письма подписываются ECDSA, отправка контролируется allowlist и человеческим одобрением. Сервер сканирует на вредоносный контент и поддерживает саморегистрацию агентов.

JavaScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин