shahabazdev/inxmail-mcp

shahabazdev/inxmail-mcp

от shahabazdev
MCP-сервер для интеграции с Inxmail Commerce API: управляйте событиями, отправками, отскоками, блок-листами и отслеживанием доставки прямо из Claude. Полезен маркетологам и разработчикам для автома...

inxmail-mcp

CI npm version npm downloads License: MIT MCP Node.js Glama Awesome MCP Servers

MCP server for the Inxmail Commerce Transactional API. Manage events, sendings, bounces, blocklist, blacklist, reactions, and delivery tracking — directly from Claude.

Quick Start

1. Install
npm install -g inxmail-mcp
# or use npx (no install needed)
2. Get API Credentials

In your Inxmail Commerce admin panel, create an API key under API Login Data. You'll get:

  • API Key ID (username)
  • API Secret (password)

Your instance name is the subdomain from your Inxmail Commerce API URL:

  • https://your-instance.api.inxmail-commerce.com/ -> instance = your-instance
3. Configure for Claude Code
claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- npx -y inxmail-mcp

Or from source:

claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- node /path/to/inxmail-mcp/build/index.js
4. Configure for Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "inxmail": {
      "command": "npx",
      "args": ["-y", "inxmail-mcp"],
      "env": {
        "INXMAIL_INSTANCE": "your-instance",
        "INXMAIL_API_KEY_ID": "your-key-id",
        "INXMAIL_API_SECRET": "your-secret"
      }
    }
  }
}
Инструменты были проиндексированы:
add_to_blacklist

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

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

    Email address to blacklist

check_email_blocked

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

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

    Email address to check

check_email_delivery

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

Параметры
  • beginstring

    ISO 8601 start date (default: last 30 days)

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

    Email address to check

  • endstring

    ISO 8601 end date (default: now)

get_blacklist_entry

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

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

    Email address to check

get_blocklist_entry

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

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

    Email address to check

get_error_log

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

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

    Error log ID

get_event_state

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

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

    Transaction ID returned from trigger_event

get_event_type

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

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

    Event type ID

get_relay_sending

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

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

    Relay sending ID

get_sending

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

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

    Sending ID

get_server_info

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

Параметры

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

list_blacklist

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

Параметры
  • beginstring

    ISO 8601 start date

  • endstring

    ISO 8601 end date

  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_blocklist

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

Параметры
  • beginstring

    ISO 8601 start date for block date range

  • endstring

    ISO 8601 end date for block date range

  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_bounces

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

Параметры
  • beginstring

    ISO 8601 start date

  • bounceTypeenum

    Filter by bounce type

  • customerIdstring

    Filter by customer ID

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • eventstring

    Filter by event type ID

  • eventIdstring

    Filter by transaction ID

  • pagenumber

    Page number (default 0)

  • sendingIdstring

    Filter by sending ID

  • sizenumber

    Page size (max 500, default 200)

list_complaints

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

Параметры
  • beginstring

    ISO 8601 start date

  • complaintTypestring

    Filter by complaint type (e.g. feedbackloop)

  • customerIdstring

    Filter by customer ID

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • eventstring

    Filter by event type ID

  • eventIdstring

    Filter by transaction ID

  • pagenumber

    Page number (default 0)

  • sendingIdstring

    Filter by sending ID

  • sizenumber

    Page size (max 500, default 200)

list_deliveries

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

Параметры
  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_error_logs

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

Параметры
  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_event_types

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

Параметры
  • namestring

    Filter by event type name

  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_reactions

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

Параметры
  • beginstring

    ISO 8601 start date

  • customerIdstring

    Filter by customer ID

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • eventstring

    Filter by event type ID

  • eventIdstring

    Filter by transaction ID

  • mailingIdstring

    Filter by mailing ID

  • pagenumber

    Page number (default 0)

  • reactionTypeenum

    Filter by reaction type

  • sendingIdstring

    Filter by sending ID

  • sizenumber

    Page size (max 500, default 200)

  • trackingHashstring

    Filter by tracking hash

list_relay_bounces

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

Параметры
  • beginstring

    ISO 8601 start date

  • bounceTypeenum

    Filter by bounce type

  • correlationId1string

    Custom correlation ID 1

  • correlationId2string

    Custom correlation ID 2

  • correlationId3string

    Custom correlation ID 3

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • pagenumber

    Page number (default 0)

  • relaySendingIdstring

    Filter by relay sending ID

  • sizenumber

    Page size (max 500, default 200)

list_relay_complaints

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

Параметры
  • beginstring

    ISO 8601 start date

  • complaintTypestring

    Filter by complaint type

  • correlationId1string

    Custom correlation ID 1

  • correlationId2string

    Custom correlation ID 2

  • correlationId3string

    Custom correlation ID 3

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • pagenumber

    Page number (default 0)

  • relaySendingIdstring

    Filter by relay sending ID

  • sizenumber

    Page size (max 500, default 200)

list_relay_reactions

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

Параметры
  • beginstring

    ISO 8601 start date

  • correlationId1string

    Custom correlation ID 1

  • correlationId2string

    Custom correlation ID 2

  • correlationId3string

    Custom correlation ID 3

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • pagenumber

    Page number (default 0)

  • reactionTypeenum

    Filter by reaction type

  • relaySendingIdstring

    Filter by relay sending ID

  • sizenumber

    Page size (max 500, default 200)

  • trackingHashstring

    Filter by tracking hash

list_relay_sendings

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

Параметры
  • beginstring

    ISO 8601 start date

  • correlationId1string

    Custom correlation ID 1

  • correlationId2string

    Custom correlation ID 2

  • correlationId3string

    Custom correlation ID 3

  • emailstring

    Filter by recipient email

  • endstring

    ISO 8601 end date

  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

list_sendings

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

Параметры
  • beginstring

    ISO 8601 start date

  • customerIdstring

    Filter by customer ID

  • emailstring

    Filter by recipient email (case-insensitive)

  • endstring

    ISO 8601 end date

  • eventstring

    Filter by event type ID

  • eventIdstring

    Filter by transaction ID

  • pagenumber

    Page number (default 0)

  • sizenumber

    Page size (max 500, default 200)

mark_error_log_read

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

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

    Error log ID

remove_from_blacklist

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

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

    Email address to remove

remove_from_blocklist

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

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

    Email address to unblock

send_raw_mail

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

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

    Base64-encoded RFC 5322 email message

trigger_event

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

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

    Event type identifier

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

    Event payload data (must contain a valid email)

  • transactionIdstring

    Unique ID for deduplication (72-hour window)

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

patchistry/patchistry-mcp-server

patchistry/patchistry-mcp-server

MCP-сервер бренда Patchistry для прямого доступа AI-агентов к каталогу. Claude, ChatGPT и Cursor могут запрашивать список холстов и патчей, получать рекомендации подборок, политику доставки и конта...

JavaScript1
railsware/mailtrap-mcp

railsware/mailtrap-mcp

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

TypeScript65
getpoststack/mcp

getpoststack/mcp

MCP сервер для PostStack Email API предоставляет AI-агентам (Claude, Cursor) 102 инструмента для отправки транзакционных писем, проверки спама, доставляемости, управления контактами и анализа рассы...

TypeScript1
MatiousCorp/google-ad-manager-mcp

MatiousCorp/google-ad-manager-mcp

Сервер для управления Google Ad Manager через естественный язык. AI-ассистенты создают кампании и креативы, проверяют доставку без интерфейса. Автоматизирует рутину маркетологов и адоперов.

Python18
cseguinlz/doubletick-cli

cseguinlz/doubletick-cli

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

JavaScript2
damientilman/mailchimp-mcp-server

damientilman/mailchimp-mcp-server

MCP-сервер для Mailchimp Marketing API с 115 инструментами: управление кампаниями, A/B-тестами, отчётами, аудиториями, лендингами, e-commerce. Есть безопасные режимы read-only и dry-run. Идеально д...

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

Лука Никитин