shahabazdev/inxmail-mcp

Явно добавляет email-адрес в черный список, навсегда блокируя все будущие письма на этот адрес. Это операция записи — получатель не будет получать никаких транзакционных или релейных писем, пока его не удалят через remove_from_blacklist. Используйте это для запросов на отказ от подписки или блокировок по требованию комплаенса. Возвращает созданную запись в черном списке.

Комплексная проверка блокировок — запрашивает за один вызов одновременно список блокировок (автоматически заблокированные из-за жестких отказов) и черный список (заблокированные вручную). Используйте это как первый шаг, когда выясняете, почему письмо не доставляется. Возвращает сводку со статусом блокировки, в каком списке находится email, и полные детали записи. Отдавайте предпочтение этому, а не отдельным вызовам get_blocklist_entry/get_blacklist_entry. Только для чтения.

Полная диагностика доставки для конкретного email-адреса. Собирает в один отчёт статус блокировки (blocklist + blacklist), отправки, отказы (hard/soft) и реакции (открытия/клики). Используйте его как основной инструмент для расследования проблем с доставкой - он заменяет необходимость по отдельности вызывать list_sendings, list_bounces, list_reactions и check_email_blocked. По умолчанию использует последние 30 дней, если не указан диапазон дат. Только чтение.

Проверяет, находится ли конкретный email в явном чёрном списке. Возвращает запись из чёрного списка с датой блокировки, если найдена, или ответ 'not blacklisted', если нет. Используйте это для поиска одного email; используйте list_blacklist для просмотра всех записей; используйте check_email_blocked для одновременной проверки blocklist и blacklist. Только для чтения.

Проверяет, находится ли конкретный email в hard-bounce blocklist. Возвращает дату блокировки и email, если найден, или ответ 'not blocked', если email отсутствует в blocklist. Используйте для поиска одного email; используйте list_blocklist для просмотра всех записей; используйте check_email_blocked для одновременной проверки blocklist и blacklist. Только чтение.

Получает полные сведения о конкретной записи лога ошибок по её идентификатору. Возвращает сообщение об ошибке, временную метку и контекст. Используйте это после нахождения записи через list_error_logs. Используйте mark_error_log_read, чтобы подтвердить её после проверки. Только чтение.

Проверяет состояние обработки ранее запущенного события. Используется после trigger_event, чтобы убедиться, было ли письмо принято, отправлено, отклонено или произошла ошибка. Возвращает детали состояния, включая информацию об ошибках. Только для чтения.

Получает детальную конфигурацию одного типа события по его ID. Возвращает имя типа события, описание и конфигурацию. Используйте этот инструмент, если у вас уже есть ID типа события и нужны его подробности; для поиска доступных ID используйте list_event_types. Только для чтения.

Получает полные сведения об отправке через почтовый ретранслятор по её ID. Возвращает получателя, временные метки, корреляционные идентификаторы и статус доставки. Используйте этот инструмент, когда у вас есть ID отправки ретранслятора из list_relay_sendings. Для отправок по событиям используйте get_sending. Только чтение.

Получает полные детали конкретной отправки транзакционного email по её ID. Возвращает получателя, тип события, временные метки и статус доставки. Используйте этот инструмент, если у вас есть конкретный ID отправки из list_sendings или get_event_state. Для отправок через mail relay используйте get_relay_sending. Только чтение.

Получить точку входа Inxmail Commerce API. Возвращает HAL+JSON с _links на все доступные ресурсы (рассылки, отказы, блок-лист, чёрный список, события и т. д.). Используйте это, чтобы обнаружить доступные конечные точки или проверить подключение к API. Только чтение, без побочных эффектов.

Выводит список email-адресов, которые были явно (вручную) занесены в чёрный список. В отличие от blocklist (автоматически заполняется из-за жёстких отказов), записи в blacklist добавляются намеренно через add_to_blacklist. Адреса из чёрного списка не могут получать письма. Используйте get_blacklist_entry, чтобы проверить конкретный email, или check_email_blocked для комбинированной проверки blocklist+blacklist. Возвращает постраничный HAL+JSON с email и датой блокировки. Только для чтения.

Список email-адресов, автоматически заблокированных из-за жестких отказов (hard bounces). Блокировочный список управляется Inxmail — адреса добавляются автоматически при возникновении жесткого отказа (hardbounce). В отличие от черного списка (управляется вручную), записи в blocklist отражают сбои доставки. Используйте get_blocklist_entry для проверки конкретного email или check_email_blocked для общей проверки. Возвращает постраничные данные в формате HAL+JSON с email и датой блокировки. Только чтение.

Выводит список отказных транзакционных писем. Отказы указывают на сбои доставки: hardbounces означают, что адрес навсегда недействителен (автоматически добавляется в блок-лист), softbounces - временные сбои (например, почтовый ящик переполнен). Используйте это для расследования проблем доставки писем, запускаемых событиями. Для откатов почтового релея используйте list_relay_bounces. Возвращает постраничные данные в формате HAL+JSON с типом отката, email, причиной и временными метками. Только чтение.

Выводит жалобы из обратной связи по транзакционным письмам. Жалобы возникают, когда получатели помечают письма как спам через своего почтового провайдера. Используйте этот метод, чтобы найти получателей, которые сообщили о нежелательных транзакционных письмах. Если нужны жалобы на почтовый ретранслятор, используйте вместо него list_relay_complaints. Возвращает постраничные данные в формате HAL+JSON с типом жалобы, email и временными метками. Только для чтения.

Выводит записи о статусе доставки, показывающие конечный результат доставки для отправленных писем. Используйте для общего обзора успешных и неудачных доставок по всем письмам. Для детальной диагностики по каждому получателю используйте check_email_delivery. Возвращает постраничный HAL+JSON с информацией о доставке. Только для чтения.

Выводит записи системного журнала ошибок из Inxmail. Ошибки включают сбои API, проблемы с рендерингом и обработкой — не ошибки возвратов/доставки (для них используйте list_bounces). Используйте для диагностики проблем на стороне сервера. Для полной информации по конкретной записи используйте get_error_log, а для подтверждения прочтения — mark_error_log_read. Возвращает постраничные данные в формате HAL+JSON. Только чтение.

Выводит список всех настроенных типов транзакционных событий в Inxmail. Типы событий определяют шаблоны и триггеры для транзакционных писем (например, подтверждение заказа, сброс пароля). Используйте это, чтобы узнать доступные ID типов событий перед вызовом trigger_event. Возвращает постраничный HAL+JSON с деталями типов событий. Только чтение.

Выводит реакции получателей (открытия и клики) для транзакционных писем. Используйте это, чтобы отслеживать вовлеченность — кто открыл или перешел по ссылкам в письмах, запускаемых событиями. Фильтруйте по типу реакции, получателю, событию, отправке или диапазону дат. Для реакций на почтовый релей используйте list_relay_reactions. Возвращает постраничный HAL+JSON с типом реакции, меткой времени и данными получателя. Только чтение.

Выводит список bounced-писем, отправленных через relay. Hardbounce обозначает постоянную ошибку доставки, softbounce — временную (например, переполнен почтовый ящик). Используйте этот метод только для писем, отправленных через relay; для транзакционных bounced-писем, вызванных событиями, используйте list_bounces. Фильтрация: по типу bounce, получателю, ID отправки relay, correlation ID или диапазону дат. Возвращает постраничные данные в формате HAL+JSON. Только чтение.

Выводит жалобы из механизма обратной связи (feedback loop) для писем, отправленных через релей. Жалобы появляются, когда получатели помечают письма, отправленные через релей, как спам. Используйте этот инструмент только для релейных писем. Для транзакционных жалоб, вызванных событиями, используйте list_complaints. Фильтруйте по типу жалобы, получателю, ID релейной отправки, корреляционным ID или диапазону дат. Возвращает постраничный ответ в формате HAL+JSON. Только для чтения.

Получает список реакций получателей (открытия и клики) на письма, отправленные через SMTP-релей. Используйте это для отслеживания вовлеченности по письмам, отправленным через релей. Для реакций на транзакционные письма, запускаемые по событиям, используйте list_reactions. Фильтруйте по типу реакции, получателю, ID отправки релея, ID корреляции или диапазону дат. Возвращает постраничные данные в формате HAL+JSON. Только для чтения.

Получение списка отправок через почтовый релей — писем, отправленных через SMTP-релей Inxmail (не по событию). Почтовый релей используется, когда ваше приложение отправляет письма через Inxmail как SMTP-шлюз. Для транзакционных писем, отправляемых по событию, используйте list_sendings. Фильтрация по получателю, идентификаторам корреляции или диапазону дат. Возвращает постраничный ответ в формате HAL+JSON. Только чтение.

Перечислить отправки транзакционных писем (только срабатывающие по событиям, не почтовый ретранслятор). Используйте это для аудита — какие транзакционные письма были отправлены, кому и когда. Фильтруйте по адресу получателя, типу события, ID клиента или диапазону дат. Для отправок через почтовый ретранслятор используйте list_relay_sendings. Для полного отчета о доставке, включая отказы и реакции, используйте check_email_delivery. Возвращает постранично HAL+JSON с деталями отправки. Только чтение.

Пометить запись лога ошибок как прочитанную/подтвержденную. Это операция записи, которая обновляет статус прочтения записи. Используйте после просмотра ошибки через get_error_log, чтобы отследить, какие ошибки были обработаны. Возвращает пустой ответ в случае успеха.

Удаляет email из явного черного списка, разрешая снова отправлять письма на этот адрес. Это операция записи. Удаляет только из черного списка (ручные блокировки). Если адрес также находится в списке блокировок (жесткие отказы), используйте также remove_from_blocklist. Возвращает пустой ответ при успехе.

Удаляет email из hard-bounce blocklist, чтобы снова отправлять транзакционные письма на этот адрес. Это операция записи — используйте с осторожностью, так как адрес ранее вызвал постоянный сбой доставки. Адрес может быть добавлен автоматически, если снова произойдет отказ. При успехе возвращает пустой ответ.

Отправляет полностью сформированное письмо в формате RFC 5322 через инфраструктуру Inxmail. Сообщение должно быть закодировано в Base64 и содержать все заголовки (From, To, Subject, MIME). Это операция записи - она отправляет реальное письмо. Используйте для разовых кастомных писем, которые не подходят под шаблон типа события. Возвращает результат отправки.

Запускает событие транзакционного email, в результате которого Inxmail отправляет письмо получателю, указанному в payload. Это операция записи: она отправляет реальное письмо. Используйте get_event_state с возвращённым transactionId для проверки результата доставки. Укажите transactionId для дедупликации в течение 72 часов. Возвращает transactionId и статус принятия.