Каталог MCP
railsware/mailtrap-mcp

railsware/mailtrap-mcp

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

README

125 инструментов

Версии

Установить сервер

MCP Mailtrap Server

An MCP server that provides tools for sending and testing in sandbox via Mailtrap.

Prerequisites

Before using this MCP server, you need to:

Create a Mailtrap account
Verify your domain
Get your API token from Mailtrap API settings
Get your Account ID from Mailtrap account management

Required Environment Variables:

MAILTRAP_API_TOKEN - Required for all functionality
MAILTRAP_ACCOUNT_ID - Required for templates, stats, email logs, sandbox list/show, and sending domains. Optional only for send-email and send-sandbox-email.

Optional (can be passed as tool parameters instead):

DEFAULT_FROM_EMAIL - Default sender email when from is not provided to send-email or send-sandbox-email. Enables switching sender per call via the from parameter.
MAILTRAP_TEST_INBOX_ID - Default test inbox ID for sandbox tools when test_inbox_id is not provided. Enables switching between inboxes per call via the test_inbox_id parameter.
MAILTRAP_SANDBOX_ID - Default sandbox ID for sandbox tools when sandbox_id is not provided. Enables switching between sandboxes per call via the sandbox_id parameter.
MAILTRAP_ORGANIZATION_ID - Required for organization tools (list-sub-accounts, create-sub-account).
MAILTRAP_ORGANIZATION_API_TOKEN - Organization-scoped API token. Required for organization tools (separate from MAILTRAP_API_TOKEN).

Инструменты были проиндексированы: 11.09.2026

batch-send-bulk-email

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

Параметры

baseobject
Shared fields applied to every request in the batch. Each request can override individual fields.
requestsobject[]обязательный
Per-recipient messages. Each request must include at least one recipient via to, cc, or bcc; other fields override base.

batch-send-sandbox-email

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

Параметры

baseobject
Shared fields applied to every request in the batch. Each request can override individual fields.
requestsobject[]обязательный
Per-recipient messages. Each request must include at least one recipient via to, cc, or bcc; other fields override base.
sandbox_idnumber
Mailtrap sandbox (test inbox) ID. Optional if MAILTRAP_SANDBOX_ID env var is set. Use to target a specific sandbox.

batch-send-transactional-email

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

Параметры

baseobject
Shared fields applied to every request in the batch. Each request can override individual fields.
requestsobject[]обязательный
Per-recipient messages. Each request must include at least one recipient via to, cc, or bcc; other fields override base.

bulk-update-permissions

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

Параметры

account_access_idnumberобязательный
ID of the account access whose permissions are being updated.
permissionsobject[]обязательный
Permission entries to create, update, or destroy. Combinations of resource_type + resource_id that already exist are updated; new combinations are created. Set destroy: true to remove an existing permission.

cancel-email-campaign

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to cancel.

clean-sandbox-inbox

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

Параметры

inbox_idnumberобязательный
ID of the sandbox inbox to clean (delete all messages from)

create-api-token

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

Параметры

expires_atstring | null
Optional token expiration as an ISO 8601 date-time (e.g. 2027-06-01T00:00:00Z). Omit for the server default (1 year). Pass an explicit null for a token that never expires. Past values or values more than 5 years ahead are rejected with a 422 error.
namestringобязательный
Display name for the API token.
resourcesobject[]
Optional list of resource permissions to attach to the token. Each entry pins the token to a specific resource at a given access level.

create-company-info

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

Параметры

addressstringобязательный
Street address.
citystringобязательный
City.
countrystringобязательный
Country.
info_levelenum
Whether the sender is a business or an individual.
namestringобязательный
Company or individual name.
phonestring
Phone number.
privacy_policy_urlstring
URL of the privacy policy page.
sending_domain_idintegerобязательный
Sending domain ID
terms_of_service_urlstring
URL of the terms of service page.
website_urlstringобязательный
Company website URL.
zip_codestringобязательный
ZIP or postal code.

create-contact

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

Параметры

emailstringобязательный
Email address of the contact.
fieldsobject
Custom field values keyed by the field's merge tag (e.g. first_name). Values may be string, number, or boolean.
list_idsnumber[]
IDs of contact lists to add this contact to.
unsubscribedboolean
If true, the contact is created in unsubscribed status.

create-contact-event

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

Параметры

contact_identifierstringобязательный
Contact ID or email to attach the event to.
namestringобязательный
Event name. Used to match contact-list automations triggered by this event.
paramsobjectобязательный
Arbitrary key/value parameters for the event. Values may be string, number, boolean, or null.

create-contact-export

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

Параметры

filtersobject[]обязательный
Filters that select which contacts to include in the export. AND-combined.

create-contact-field

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

Параметры

data_typeenumобязательный
Data type stored in this field.
merge_tagstringобязательный
Merge tag used in template variables (e.g. first_name). Must be unique.
namestringобязательный
Display name of the field (e.g. "First Name").

create-contact-import

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

Параметры

contactsobject[]обязательный
Contacts to import. Each entry needs at least an email; optionally include custom fields, list_ids_included, and list_ids_excluded.

create-contact-list

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

Параметры

namestringобязательный
Name for the new contact list.

create-email-campaign

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

Параметры

contact_list_idsinteger[]
IDs of contact lists to send to. Treated as the full set of included lists. Combine with contact_segment_ids to target both.
contact_segment_idsinteger[]
IDs of contact segments to send to. Treated as the full set of included segments.
delivery_modeenum
How the campaign is delivered. rapid sends as fast as possible; gradual throttles sending to delivery_options.emails_per_hour.
delivery_optionsobject
Delivery throttling options. Applies when delivery_mode is gradual.
domain_idintegerобязательный
ID of the verified sending domain used for the campaign, as returned by the Sending Domains endpoints.
from_display_namestring
Display name shown in the From header.
from_local_partstringобязательный
Local part (before the @) of the From address.
namestringобязательный
Campaign name.
reply_toobject
Reply-To address parts.
template_attributesobjectобязательный
Inline email template — the campaign's subject and design.

create-inbound-folder

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

Параметры

namestringобязательный
The folder name.

create-inbound-inbox

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

Параметры

domain_idnumber
Optional. Attach the inbox to a custom sending domain (catch-all inbox). Omit for a standard Mailtrap-hosted inbox.
folder_idnumberобязательный
The inbound folder ID to create the inbox in.
namestringобязательный
The inbox name.

create-sandbox-inbox

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

Параметры

namestringобязательный
Name of the inbox
project_idnumberобязательный
ID of the project to create the inbox in

create-sandbox-project

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

Параметры

namestringобязательный
Name of the project (2–100 characters)

create-sending-domain

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

Параметры

domain_namestringобязательный
Domain name (e.g. example.com)

create-sub-account

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

Параметры

namestringобязательный
Display name for the new sub-account.

create-suppression

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

Параметры

domain_idintegerобязательный
ID of the sending domain the suppression applies to, as returned by the Sending Domains tools.
emailstringобязательный
Email address to suppress.
sending_streamenumобязательный
Sending stream to suppress the address for.
typeenum
Reason recorded for the suppression. Defaults to manual import when omitted.

create-template

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

Параметры

categorystring
Template category (optional, defaults to 'General')
htmlstring
HTML content of the template (optional)
namestringобязательный
Name of the template
subjectstringобязательный
Email subject line
textstring
Plain text version of the template (optional)

create-tracking-opt-out

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

Параметры

domain_idintegerобязательный
ID of the sending domain the opt-out applies to, as returned by the Sending Domains tools.
emailstringобязательный
Email address to opt out of open and click tracking.

create-webhook

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

Параметры

activeboolean
Whether the webhook is enabled. Defaults to true.
domain_idnumber
Sending domain ID to scope this webhook to. Applies only to email_sending webhooks.
event_typesenum[]
Events to subscribe to. Applies only to email_sending webhooks.
inbound_inbox_idnumber
ID of the inbound inbox the webhook is linked to. Applicable only for inbound_receiving webhooks; optional — omit to apply to all inboxes in the account.
payload_formatenum
Payload encoding. Defaults to json.
sending_streamenum
Sending stream this webhook subscribes to. Applies only to email_sending webhooks.
urlstringобязательный
URL that Mailtrap will POST webhook events to.
webhook_typeenumобязательный
Webhook category. email_sending for delivery/open/click/etc events, audit_log for account audit events, inbound_receiving for inbound inbox events.

delete-api-token

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

Параметры

api_token_idnumberобязательный
ID of the API token.

delete-contact

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

Параметры

contact_identifierstringобязательный
Contact ID or email to delete.

delete-contact-field

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

Параметры

field_idnumberобязательный
ID of the contact field to delete.

delete-contact-list

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

Параметры

list_idnumberобязательный
ID of the contact list to delete.

delete-email-campaign

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to delete.

delete-inbound-folder

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

Параметры

folder_idnumberобязательный
The inbound folder ID.

delete-inbound-inbox

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

Параметры

folder_idnumberобязательный
The inbound folder ID.
inbox_idnumberобязательный
The inbox ID.

delete-inbound-message

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

Параметры

inbox_idnumberобязательный
The inbox ID.
message_idstringобязательный
The message ID.

delete-inbound-thread

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

Параметры

inbox_idnumberобязательный
The inbox ID.
thread_idstringобязательный
The thread ID.

delete-sandbox-inbox

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

Параметры

inbox_idnumberобязательный
ID of the sandbox inbox to delete

delete-sandbox-message

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

delete-sandbox-project

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

Параметры

project_idnumberобязательный
ID of the project to delete

delete-sending-domain

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

Параметры

sending_domain_idnumberобязательный
Sending domain ID to delete

delete-suppression

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

Параметры

suppression_idstringобязательный
ID of the suppression to delete

delete-template

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

Параметры

template_idnumberобязательный
ID of the template to delete

delete-tracking-opt-out

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

Параметры

tracking_opt_out_idstringобязательный
ID of the tracking opt-out to delete

delete-webhook

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

Параметры

webhook_idnumberобязательный
ID of the webhook to delete

enable-sandbox-email-address

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

Параметры

sandbox_idnumberобязательный
ID of the sandbox to act on

forward-inbound-message

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

Параметры

attachmentsobject[]
File attachments.
bccobject[]
Optional BCC recipients as { email, name? } objects (bare email strings also accepted)
categorystring
Message category.
ccobject[]
Optional CC recipients as { email, name? } objects (bare email strings also accepted)
custom_variablesobject
Custom variables.
fromobject
Sender. Rejected for Mailtrap-hosted inboxes; required for custom-domain inboxes.
headersobject
Custom headers.
htmlstring
HTML body.
inbox_idnumberобязательный
The inbox ID.
message_idstringобязательный
The message ID to forward.
reply_toobject
Reply-To address.
textstring
Plain-text body.
toobject[]обязательный
Recipients. Defaults to the original sender for reply/reply_all when omitted; required for forward.

forward-sandbox-message

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

Параметры

emailstringобязательный
Email address to forward the message to
message_idnumberобязательный
ID of the sandbox message to forward
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

api_token_idnumberобязательный
ID of the API token.

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обязательный
Sending domain ID

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

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

Параметры

contact_identifierstringобязательный
Contact ID or email address.

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

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

Параметры

export_idnumberобязательный
ID of the contact export job to fetch.

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

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

Параметры

field_idnumberобязательный
ID of the contact field to fetch.

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

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

Параметры

import_idnumberобязательный
ID of the contact import job to fetch.

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

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

Параметры

list_idnumberобязательный
ID of the contact list to fetch.

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

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to fetch.

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

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign.
end_datestring
End of the aggregation window (inclusive), in YYYY-MM-DD format. Defaults to the current date.
start_datestring
Start of the aggregation window (inclusive), in YYYY-MM-DD format. Defaults to the day the campaign was last started.

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

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

Параметры

include_contentboolean
When true, download the raw EML message (if available) and include parsed HTML and text body content, similar to show-sandbox-email-message.
message_idstringобязательный
UUID of the email log message (from send response or list-email-logs)

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

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

Параметры

folder_idnumberобязательный
The inbound folder ID.

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

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

Параметры

folder_idnumberобязательный
The inbound folder ID.
inbox_idnumberобязательный
The inbox ID.

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

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

Параметры

inbox_idnumberобязательный
The inbox ID.
message_idstringобязательный
The message ID.

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

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

Параметры

inbox_idnumberобязательный
The inbox ID.
thread_idstringобязательный
The thread ID.

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

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

Параметры

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

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

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

Параметры

attachment_idnumberобязательный
ID of the attachment to fetch
message_idnumberобязательный
ID of the sandbox message that contains the attachment
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

inbox_idnumber
ID of the sandbox inbox. Optional if MAILTRAP_TEST_INBOX_ID env var is set.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

last_idnumber
Pagination using last message ID. Returns messages after the specified message ID.
pagenumber
Page number for pagination
searchstring
Search query to filter messages
test_inbox_idnumber
Mailtrap test inbox ID. Optional if MAILTRAP_TEST_INBOX_ID env var is set. Use to target a specific inbox.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

project_idnumberобязательный
ID of the project to fetch

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

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

Параметры

include_setup_instructionsboolean
If true, append DNS setup instructions to the response.
sending_domain_idnumberобязательный
Sending domain ID

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

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

Параметры

breakdownenum
How to break down the stats: aggregated (default), by_domain, by_category, by_email_service_provider, or by_date
categoriesstring[]
Optional filter: limit to these email categories
email_service_providersstring[]
Optional filter: limit to these email service providers (e.g. Google, Yahoo, Outlook)
end_datestringобязательный
End date for the stats range (YYYY-MM-DD)
sending_domain_idsinteger[]
Optional filter: limit to these sending domain IDs
sending_streamsenum[]
Optional filter: limit to transactional and/or bulk stream
start_datestringобязательный
Start date for the stats range (YYYY-MM-DD)

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

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

Параметры

template_idnumberобязательный
ID of the template to fetch

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

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

Параметры

webhook_idnumberобязательный
ID of the webhook to fetch

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

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

Параметры

domain_uuidsstring[]
Optional: filter by sending domain UUIDs.
inbox_idsstring[]
Optional: filter by sandbox inbox IDs.
project_idsstring[]
Optional: filter by sandbox project IDs.

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

searchstring
Filter contact lists by name (case-insensitive match), e.g. "news".

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

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

Параметры

per_pageinteger
Number of campaigns per page. Defaults to 50, maximum 100.
searchstring
Filter campaigns by name (case-insensitive partial match), e.g. "spring".
tokeninteger
Page number to retrieve (page-token pagination). Defaults to 1.

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

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

Параметры

categorystring | string[]
Filter by email category. Use with category_operator. Single value, array (e.g. ["Newsletter", "Alert"]), or comma-separated string (e.g. "Newsletter,Alert") for multiple (OR).
category_operatorenum
Operator for category. Default: equal.
clicks_countnumber
Filter by number of link clicks. Use with clicks_count_operator.
clicks_count_operatorenum
Operator for clicks_count. Default: equal.
client_ipstring
Filter by client IP. Use with client_ip_operator.
client_ip_operatorenum
Operator for client_ip. Default: equal.
email_service_providerstring | string[]
Filter by email service provider (exact). Single value or array. Use with *_operator.
email_service_provider_operatorenum
Operator for email_service_provider. Default: equal.
email_service_provider_responsestring | string[]
Filter by provider response text. Single value or array. Use with *_operator.
email_service_provider_response_operatorenum
Operator for email_service_provider_response. Default: ci_contain.
eventsenum | enum[]
Filter by event type(s). Use with events_operator: include_event or not_include_event.
events_operatorenum
Operator for events filter. Default: include_event.
from_emailstring | string[]
Filter by sender email (use with from_operator). Single value or array.
from_operatorenum
Operator for from_email filter. Default: ci_equal. ci_contain/ci_not_contain match substring; ci_equal/ci_not_equal match exactly (case-insensitive).
opens_countnumber
Filter by number of opens. Use with opens_count_operator.
opens_count_operatorenum
Operator for opens_count. Default: equal.
recipient_mxstring | string[]
Filter by recipient MX. Single value or array. Use with recipient_mx_operator.
recipient_mx_operatorenum
Operator for recipient_mx. Default: ci_contain.
search_afterstring
Pagination cursor from the previous response's next_page_cursor to fetch the next page
sending_domain_idnumber | number[]
Filter by sending domain ID. Single value or array. Find IDs in Mailtrap Sending Domains.
sending_domain_id_operatorenum
Operator for sending_domain_id filter. Default: equal.
sending_ipstring
Filter by sending IP. Use with sending_ip_operator.
sending_ip_operatorenum
Operator for sending_ip. Default: equal.
sending_streamenum | enum[]
Filter by sending stream: transactional or bulk. Single value or array.
sending_stream_operatorenum
Operator for sending_stream filter. Default: equal.
sent_afterstring
ISO 8601 date/time; only return logs for emails sent after this time
sent_beforestring
ISO 8601 date/time; only return logs for emails sent before this time
statusenum | enum[]
Filter by delivery status (use with status_operator). Single value or array.
status_operatorenum
Operator for status filter. Default: equal.
subjectstring | string[]
Filter by email subject (use with subject_operator). Single value or array. Omit for empty/not_empty.
subject_operatorenum
Operator for subject filter. Default: ci_contain. Use empty/not_empty to filter by presence of subject.
to_emailstring | string[]
Filter by recipient email (use with to_operator). Single value or array.
to_operatorenum
Operator for to_email filter. Default: ci_equal.

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

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

Параметры

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

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

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

Параметры

folder_idnumberобязательный
The inbound folder ID to list inboxes for.

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

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

Параметры

inbox_idnumberобязательный
The inbox ID to list messages for.
last_idstring
Pagination cursor from a previous response's last_id.

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

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

Параметры

inbox_idnumberобязательный
The inbox ID to list threads for.
last_idstring
Pagination cursor from a previous response's last_id.

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

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

Параметры

message_idnumberобязательный
ID of the sandbox message
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

emailstring
Optional email filter. Returns suppressions matching this address.

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

Перечисляет все шаблоны писем

Параметры

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

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

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

Параметры

emailstring
Optional email filter. Returns tracking opt-outs matching this address.
end_timestring
Only opt-outs created at or before this time (ISO 8601, e.g. 2026-08-31T23:59:59Z).
last_idstring
Pagination cursor — the last_id from the previous response, to fetch the next page.
start_timestring
Only opt-outs created at or after this time (ISO 8601, e.g. 2026-08-01T00:00:00Z).

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

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

Параметры

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

mark-sandbox-as-read

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

Параметры

sandbox_idnumberобязательный
ID of the sandbox to act on

remove-account-access

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

Параметры

account_access_idnumberобязательный
ID of the account access to remove.

reply-all-to-inbound-message

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

Параметры

attachmentsobject[]
File attachments.
bccobject[]
Optional BCC recipients as { email, name? } objects (bare email strings also accepted)
categorystring
Message category.
ccobject[]
Optional CC recipients as { email, name? } objects (bare email strings also accepted)
custom_variablesobject
Custom variables.
fromobject
Sender. Rejected for Mailtrap-hosted inboxes; required for custom-domain inboxes.
headersobject
Custom headers.
htmlstring
HTML body.
inbox_idnumberобязательный
The inbox ID.
message_idstringобязательный
The message ID to reply to.
reply_toobject
Reply-To address.
textstring
Plain-text body.
toobject[]
Recipients. Defaults to the original sender for reply/reply_all when omitted; required for forward.

reply-to-inbound-message

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

Параметры

attachmentsobject[]
File attachments.
bccobject[]
Optional BCC recipients as { email, name? } objects (bare email strings also accepted)
categorystring
Message category.
ccobject[]
Optional CC recipients as { email, name? } objects (bare email strings also accepted)
custom_variablesobject
Custom variables.
fromobject
Sender. Rejected for Mailtrap-hosted inboxes; required for custom-domain inboxes.
headersobject
Custom headers.
htmlstring
HTML body.
inbox_idnumberобязательный
The inbox ID.
message_idstringобязательный
The message ID to reply to.
reply_toobject
Reply-To address.
textstring
Plain-text body.
toobject[]
Recipients. Defaults to the original sender for reply/reply_all when omitted; required for forward.

reset-api-token

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

Параметры

api_token_idnumberобязательный
ID of the API token.
expires_atstring | null
Optional expiration for the new token as an ISO 8601 date-time (e.g. 2027-06-01T00:00:00Z). Omit for the server default (1 year). Pass an explicit null for a token that never expires. Past values or values more than 5 years ahead are rejected with a 422 error.

reset-email-campaign

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to reset.

reset-sandbox-credentials

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

Параметры

sandbox_idnumberобязательный
ID of the sandbox to act on

reset-sandbox-email-address

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

Параметры

sandbox_idnumberобязательный
ID of the sandbox to act on

schedule-email-campaign

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

Параметры

datetimestringобязательный
When to send the campaign (ISO 8601, e.g. 2026-09-01T09:00:00Z or with a UTC offset). Must be in the future and no more than 1 month ahead, otherwise the request is rejected with 422.
email_campaign_idintegerобязательный
Unique identifier of the email campaign to schedule.

send-email

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

Параметры

bccobject[]
Optional BCC recipients as { email, name? } objects (bare email strings also accepted)
categorystring
Optional email category for tracking. Must be omitted when template_uuid is set.
ccobject[]
Optional CC recipients as { email, name? } objects (bare email strings also accepted)
fromobject
Sender as { email, name? } (a bare email string is also accepted). Omit if DEFAULT_FROM_EMAIL is set.
htmlstring
Optional HTML version of the email body. Must be omitted when template_uuid is set.
subjectstring
Email subject line. Required for inline (text/html) sends; must be omitted when template_uuid is set.
template_uuidstring
Use a Mailtrap email template instead of inline content. When set, subject, text, html, and category must be omitted (per Mailtrap API).
template_variablesobject
Variables substituted into the template referenced by template_uuid. Only allowed together with template_uuid; rejected otherwise.
textstring
Email body text. Required (alongside or instead of html) for inline sends; must be omitted when template_uuid is set.
toobject[]
Recipients as an array of { email, name? } objects (bare email strings are also accepted as items). Optional if cc or bcc is provided; at least one of to/cc/bcc must contain a recipient.

send-sandbox-email

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

Параметры

bccobject[]
Optional BCC recipients as { email, name? } objects (bare email strings also accepted)
categorystring
Optional email category for tracking. Must be omitted when template_uuid is set.
ccobject[]
Optional CC recipients as { email, name? } objects (bare email strings also accepted)
fromobject
Sender as { email, name? } (a bare email string is also accepted). Omit if DEFAULT_FROM_EMAIL is set.
htmlstring
Optional HTML version of the email body. Must be omitted when template_uuid is set.
subjectstring
Email subject line. Required for inline (text/html) sends; must be omitted when template_uuid is set.
template_uuidstring
Use a Mailtrap email template instead of inline content. When set, subject, text, html, and category must be omitted (per Mailtrap API).
template_variablesobject
Variables substituted into the template referenced by template_uuid. Only allowed together with template_uuid; rejected otherwise.
test_inbox_idnumber
Mailtrap test inbox ID. Optional if MAILTRAP_TEST_INBOX_ID env var is set. Use to target a specific inbox.
textstring
Email body text. Required (alongside or instead of html) for inline sends; must be omitted when template_uuid is set.
toobject[]
Recipients as an array of { email, name? } objects (bare email strings as items, or a comma-separated string of plain emails, are also accepted). Optional if cc or bcc is provided; at least one of to/cc/bcc must contain a recipient.

send-sending-domain-setup-instructions

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

Параметры

emailstringобязательный
Email address to send DNS setup instructions to
sending_domain_idnumberобязательный
Sending domain ID

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

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

Параметры

include_html_analysisboolean
When true, include HTML analysis (client compatibility, problematic elements). Critical for email client testing.
include_spam_reportboolean
When true, include spam report (SpamAssassin score and details). Critical for deliverability testing.
message_idnumberобязательный
ID of the sandbox email message to retrieve
test_inbox_idnumber
Mailtrap test inbox ID. Optional if MAILTRAP_TEST_INBOX_ID env var is set. Use to target a specific inbox.

start-email-campaign

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to start.

terminate-email-campaign

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

Параметры

email_campaign_idintegerобязательный
Unique identifier of the email campaign to terminate.

update-company-info

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

Параметры

addressstring
Street address.
citystring
City.
countrystring
Country.
info_levelenum
Whether the sender is a business or an individual.
namestring
Company or individual name.
phonestring
Phone number.
privacy_policy_urlstring
URL of the privacy policy page.
sending_domain_idintegerобязательный
Sending domain ID
terms_of_service_urlstring
URL of the terms of service page.
website_urlstring
Company website URL.
zip_codestring
ZIP or postal code.

update-contact

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

Параметры

contact_identifierstringобязательный
Contact ID or email to update.
emailstring
New email address for the contact.
fieldsobject
Custom field values to set, keyed by merge tag. String, number, or boolean values.
list_idsnumber[]
Replace the contact's list memberships with this exact set of list IDs.
list_ids_excludednumber[]
List IDs to remove the contact from.
list_ids_includednumber[]
List IDs to add the contact to (additive).
unsubscribedboolean
Move the contact to unsubscribed (true) or subscribed (false) status.

update-contact-field

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

Параметры

data_typeenum
New data type for the field.
field_idnumberобязательный
ID of the contact field to update.
merge_tagstring
New merge tag for the field. Must be unique.
namestring
New display name for the field.

update-contact-list

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

Параметры

list_idnumberобязательный
ID of the contact list to update.
namestringобязательный
New name for the contact list.

update-email-campaign

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

Параметры

contact_list_idsinteger[]
IDs of contact lists to send to. Treated as the full set of included lists — lists not listed are removed.
contact_segment_idsinteger[]
IDs of contact segments to send to. Treated as the full set of included segments.
delivery_modeenum
How the campaign is delivered. rapid sends as fast as possible; gradual throttles sending to delivery_options.emails_per_hour.
delivery_optionsobject
Delivery throttling options. Applies when delivery_mode is gradual.
domain_idinteger
ID of the verified sending domain used for the campaign, as returned by the Sending Domains endpoints.
email_campaign_idintegerобязательный
Unique identifier of the email campaign to update.
from_display_namestring
Display name shown in the From header.
from_local_partstring
Local part (before the @) of the From address.
namestring
Campaign name.
reply_toobject
Reply-To address parts.
template_attributesobject
Inline email template — the campaign's template is edited in place. Updates are partial: only the sub-fields you provide change.

update-inbound-folder

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

Параметры

folder_idnumberобязательный
The inbound folder ID.
namestringобязательный
The new folder name.

update-inbound-inbox

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

Параметры

folder_idnumberобязательный
The inbound folder ID.
inbox_idnumberобязательный
The inbox ID.
namestringобязательный
The new inbox name.

update-sandbox-inbox

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

Параметры

email_usernamestring
New email username for the inbox
inbox_idnumberобязательный
ID of the sandbox inbox to update
namestring
New name for the inbox

update-sandbox-message

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

Параметры

is_readbooleanобязательный
Mark the message as read (true) or unread (false)
message_idnumberобязательный
ID of the sandbox message to update
sandbox_idnumber
Sandbox ID. Falls back to MAILTRAP_SANDBOX_ID env var if omitted.

update-sandbox-project

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

Параметры

namestringобязательный
New name for the project (2–100 characters)
project_idnumberобязательный
ID of the project to update

update-sending-domain

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

Параметры

auto_unsubscribe_link_enabledboolean
Automatically add an unsubscribe link to emails.
click_tracking_enabledboolean
Track clicks on links in emails sent from this domain.
inbound_enabledboolean
Allow the domain to be attached to an inbound inbox as a catch-all.
open_tracking_enabledboolean
Track opens on emails sent from this domain.
sending_domain_idintegerобязательный
Sending domain ID
tracking_opt_out_enabledboolean
Add the tracking opt-out link to tracked emails. Requires open or click tracking.

update-template

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

Параметры

categorystring
New category for the template
htmlstring
New HTML content of the template
namestring
New name for the template
subjectstring
New email subject line
template_idnumberобязательный
ID of the template to update
textstring
New plain text version of the template

update-webhook

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

Параметры

activeboolean
Enable or disable the webhook.
event_typesenum[]
Events to subscribe to. Applies only to email_sending webhooks.
inbound_inbox_idnumber
ID of the inbound inbox the webhook is linked to. Applicable only for inbound_receiving webhooks.
payload_formatenum
Payload encoding.
urlstring
New URL that Mailtrap will POST webhook events to.
webhook_idnumberобязательный
ID of the webhook to update

Github Сайт сервера

Конфиг для установки сервера

{
  "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}"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Что он умеет?

Отправляет email: одиночные, пачкой транзакционные и bulk, а также тестовые в sandbox. Создаёт, переименовывает, очищает и удаляет sandbox-проекты и ящики, пересылает сообщения, читает тело письма (текст, HTML, raw, EML, заголовки, вложения), спам-отчёт и HTML-анализ. Управляет контактами и списками: создаёт, редактирует, удаляет, импортирует и экспортирует, задаёт поля и события. Строит и запускает email-кампании, планирует и отменяет их, собирает статистику. Настраивает шаблоны, домены, вебхуки, suppression-списки, трекинг отписок, входящие сообщения и нити, API-токены, доступы и биллинг.

Информация о сервере

Номер в рейтинге: #192
Звезд на Github: 65
Форков на Github: 13
Загрузок: 9 194
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:52
Идентификатор: 5-7vV7P7VNET-_TB
Категории: Инструменты для разработчиков, Коммуникации, Тестирование и QA, Электронная почта