@mailkite/mcp

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

Официальная библиотека MailKite для агентов на основе MCP.

Docs · Library guide · mailkite.dev · AI agents

Только зеркало для чтения. Этот репозиторий — сгенерированное зеркало выпуска (правая копия источника) монорепозитория MailKite — развитие здесь не происходит. Устанавливайте из npm и создавайтеIssues к MailKite docs.

Install

{
  "mcpServers": {
    "mailkite": {
      "command": "npx",
      "args": ["-y", "@mailkite/mcp"],
      "env": { "MAILKITE_API_KEY": "mk_live_…" }
    }
  }
}

Tools

Один инструмент на каждый метод MailKite API, сгенерированный из общего контракта. Полный список + схемы: https://mailkite.dev/docs/libraries#mcp.

70 инструментов, созданных по shared API contract — той же спецификации, которую сервер регистрирует при запуске. * помечает обязательный аргумент. Доступ: API key (mk_live_…), session (управляющий токен) или local (работает внутри процесса, без сети).

Инструмент	Подпись	Доступ	Что делает
mailkite_send	from: string, to: any, subject: string, html: string, text: string, templateId: string, templateData: object, cc: any, bcc: any, replyTo: string, inReplyTo: string, headers: object, attachments: array, scheduledAt: string,number, trackOpens: boolean, trackClicks: boolean	API key · write	Отправить сообщение через проверяемый домен.
mailkite_send_batch	from: string, recipients: array, subject: string, html: string, text: string, templateId: string, templateData: object, headers: object, replyTo: string, inReplyTo: string, attachments: array, scheduledAt: string,number, trackOpens: boolean, trackClicks: boolean	API key · write	Отправить одно персонализированное сообщение каждому получателю (до 50) в одном вызове.
mailkite_upload_attachment	filename: string, path: string, url: string, content: string, contentType: string, retentionDays: integer	API key · write	Загрузить файл в MailKite storage и вернуть безопасную, ограниченную по времени URL.
mailkite_list_templates	—	session · read	Перечислить сохранённые шаблоны писем (только базовые метаданные — без тела).
mailkite_list_base_templates	—	session · read	Перечислить предустановленные базовые шаблоны (легкие метаданные).
mailkite_get_template	id*	session · read	Получить один шаблон (полный: тема, html, text, тема оформления).
mailkite_create_template	baseId: string, name: string, subject: string, html: string, text: string, json: string, theme: string	session · write	Создать шаблон.
mailkite_list_domains	—	session · read	Перечислить ваши домены, каждый с URL вашего webhook.
mailkite_create_domain	domain*: string	session · write	Добавить домен.
mailkite_get_domain	id*	session · read	Получить один домен с DNS-записями и webhook.
mailkite_delete_domain	id*	session · delete/replace	Удалить домен.
mailkite_verify_domain	id*	session · write	Проверить DNS и обновить статус.
mailkite_set_webhook	id, url: string	session · delete/replace	Установить или заменить catch-all webhook домена.
mailkite_set_tracking_webhook	id, url: string	session · delete/replace	Установить или заменить выделенный tracking-event webhook домена: HTTPS-эндпойнт, получающий подписанные события engagement (email.sent / email.bounced / email.complained / email.opened / email.clicked, сформированные согласно схеме tracking-event) отдельно от входящей почты.
mailkite_delete_tracking_webhook	id*	session · delete/replace	Удалить tracking-event webhook домена (engagement-события прекращаются).
mailkite_set_webhook_events	id, events: any	session · delete/replace	Включить inbound webhook домена в события engagement — один вебхук, все события.
mailkite_delete_webhook_events	id*	session · delete/replace	Отключить inbound webhook домена от engagement-событий (получать только входящую почту — по умолчанию).
mailkite_delete_webhook	id*	session · delete/replace	Удалить webhook домена.
mailkite_test_webhook	id*	session · write	Отправить подписанное тестовое событие в вебхук домена.
mailkite_check_domain_availability	domain*	session · read	Проверить, доступен ли домен для регистрации и по какой цене.
mailkite_register_domain	domain: string, contact: object, years: integer, dryRun: boolean	session · write	Зарегистрировать (купить) домен от имени клиента; настройка DNS Mail и добавление в учетную запись в одном вызове.
mailkite_list_routes	—	session · read	Перечислить inbound-правила маршрутизации.
mailkite_create_route	match*: string, action: string, destination: string, agentPrompt: string, agentForwardTo: array, agentContext: string	session · write	Создать маршрут (match, action, destination).
mailkite_delete_route	id*	session · delete/replace	Удалить маршрут по идентификатору.
mailkite_agent	text*: string, subject: string, from: string, html: string, routeId: string, address: string, model: string	API key · write	Отправить сообщение одному из ваших inbox-агентов и получить ответ.
mailkite_route	routeId: string, address: string, from*: string, subject: string, text: string, html: string	API key · write	Маршрутизировать сообщение к одному из зарегистрированных маршрутов (по routeId или адресу) и выполнить действие маршрута — агент, webhook или пересылка.
mailkite_list_messages	—	session · read	Перечислить сохранённые сообщения, сначала новые.
mailkite_get_message	id*	session · read	Получить сообщение с доставками и вложениями.
mailkite_retry_delivery	id*	session · write	Повторно отправить сохранённое сообщение на его webhook.
mailkite_list_lists	—	session · read	Перечислить ваши списки контактов (статические, подобранные аудитории), с количеством участников.
mailkite_create_list	name*: string	session · write	Создать список контактов.
mailkite_get_list	id*	session · read	Получить один список контактов с количеством участников.
mailkite_update_list	id, name: string	session · write	Переименовать список контактов.
mailkite_delete_list	id*	session · delete/replace	Удалить список контактов.
mailkite_list_list_contacts	id*	session · read	Перечислить контакты, входящие в список, с сортировкой newest first.
mailkite_add_list_contacts	id, contactIds: array	session · write	Добавлять контакты (по id, ctr_…) в список.
mailkite_remove_list_contact	id, contactId	session · delete/replace	Удалить один контакт из списка (сам контакт остаётся в списке).
mailkite_list_broadcasts	—	session · read	Перечислить ваши рассылки (один ко множеству) с состоянием и статистикой отправки.
mailkite_create_broadcast	name: string, from*: string, replyTo: string, subject: string, preview: string, audience: object, templateId: string, html: string, text: string, footerAddress: string	session · write	Создать черновик рассылки.
mailkite_get_broadcast	id*	session · read	Получить одну рассылку с её статусом и сводкой по получателям.
mailkite_update_broadcast	id*, name: string, from: string, replyTo: string, subject: string, preview: string, audience: object, templateId: string, html: string, text: string, footerAddress: string	session · write	Редактировать черновик рассылки (изменить from/subject/audience/html/... ).
mailkite_delete_broadcast	id*	session · delete/replace	Удалить черновик рассылки.
mailkite_send_broadcast	id*, scheduledAt: string	session · write	Отправить рассылку сейчас или запланировать на ISO 8601 через scheduledAt.
mailkite_verify_webhook	payload: string, signature: string, secret*: string, toleranceMs: integer	local · read	Проверить заголовок x-mailkite-signature на входящем доставке вебхука.
mailkite_semantic_search	query*	API key · read	Семантический поиск по документации MailKite — возвращает наиболее релевантные разделы документации по естественному языковому запросу (гибрид векторного и ключевого поиска по https://mailkite.dev/docs).
mailkite_set_retention	id, zeroRetention: boolean	session · delete/replace	Включить/выключить нулевой retention-пасстрок для домена ({ zeroRetention }).
mailkite_set_encryption	id, publicKey: string	session · delete/replace	Включить шифрование в покое для домена с использованием открытого ключа ({ publicKey }).
mailkite_delete_encryption	id*	session · delete/replace	Отключить шифрование в покое для домена.
mailkite_list_schemas	—	API key · read	Перечислить все опубликованные JSON Schema с URL-адресами, по которым они доступны.
mailkite_get_schema	name*	API key · read	Получить один schema как application/schema+json, с абсолютным $id, который валидатор может разрешить и закешировать.
mailkite_signup	email: string, password: string, ref: string, channel: string, referrer: string	session · write	Создать учётную запись.
mailkite_login	email: string, password: string	session · write	Войти по email и паролю.
mailkite_google_signin	code: string, redirectUri: string, ref: string	session · write	Войти, используя Google auth code.
mailkite_get_api_key	—	session · read	Получить безлимитный API-ключ учётной записи (mk_live_…).
mailkite_rotate_api_key	—	session · write	Вращение API-ключа: старый ключ перестаёт работать, возвращается новый.
mailkite_list_scoped_keys	—	session · read	Перечень доменно-ограниченных API-ключей учётной записи.
mailkite_create_scoped_key	domainId*: string, name: string	session · write	Создать ключ с ограничением на один домен.
mailkite_delete_scoped_key	id*	session · delete/replace	Отозвать доменно-ограниченный ключ.
mailkite_list_app_passwords	—	session · read	Перечень паролей приложений учётной записи.
mailkite_create_app_password	domain*: string, domainId: string, address: string, protocols: array, label: string	session · write	Создать пароль приложения для одного домена и шаблона адреса.
mailkite_delete_app_password	id*	session · delete/replace	Отозвать пароль приложения.
mailkite_list_mailbox_messages	address*	session · read	Перечислить сообщения почтового ящика, начиная с самых новых.
mailkite_get_mailbox_message_raw	uid, address	session · read	Получить raw RFC822 байты одного сообщения из почтового ящика.
mailkite_set_mailbox_message_flags	uid, address, flags*: string	session · write	Заменить флаги IMAP сообщения (например,…
mailkite_get_usage	—	session · read	Текущее использование в расчётном периоде: отправлено писем по плану, действия ИИ и стейт сверх лимита, влияющий на отправку.
mailkite_list_suppressions	—	session · read	Перечень подавляемых адресов (отписки, жесткие отказы, жалобы на спам, вручную).
mailkite_add_suppression	email*: string, reason: string, note: string	session · write	Подавить адрес, чтобы эта учетная запись больше не отправляла на него — причина по умолчанию: manual.
mailkite_remove_suppression	email*	session · delete/replace	Удалить адрес из списка подавлений (адрес URL-кодируется в пути).
mailkite_register	email*: string, channel: string, ref: string, referrer: string	session · write	Создать учётную запись MailKite только по email — без пароля.
mailkite_me	—	API key · read	Учётная запись, связанная с этим креденшелом: email, подтверждён ли она (отправка заблокирована до подтверждения) и план.

Use it from an AI agent — MCP + Agent connectors

MailKite поддерживает Model Context Protocol: каждый API-метод — это инструмент, который ваш AI-ассистент (Claude, Cursor, …) может вызвать — отправлять письма, управлять доменами, искать документацию и сдавать агенту его собственный inbox. Полное руководство: https://mailkite.dev/docs/ai-agents.

Хостинг (рекомендуется) — единоразовый OAuth, без копирования ключа:

claude mcp add --transport http mailkite https://mcp.mailkite.dev/mcp

В Claude Code можно также установить плагин:

/plugin marketplace add mailkite/claude-code
/plugin install mailkite@mailkite

Любой чат-агент: «Добавьте сервер MCP по адресу https://mcp.mailkite.dev/mcp и аутентифицируйтесь в браузере при запросе.»

Локальный (статический ключ, оффлайн / CI):

{ "mcpServers": { "mailkite": { "command": "npx", "args": ["-y", "@mailkite/mcp"], "env": { "MAILKITE_API_KEY": "mk_live_…" } } } }

Дайте агенту его собственный inbox. Направляйте входящую почту в встроенного inbox-агента (через действие маршрута agent) — он отвечает, файловирует или эскалирует самостоятельно — смотрите https://mailkite.dev/docs/ai-agents.

All MailKite libraries

Один контракт — множество языков реализации — выберите подходящий для вашего стека (полный список: https://mailkite.dev/docs/libraries):

Библиотека	Репо	Распределение
MailKite для Node.js	mailkite-node	npm
MailKite для Python	mailkite-python	PyPI
MailKite для Ruby	mailkite-ruby	RubyGems
MailKite для Java	mailkite-java	Maven Central
MailKite для PHP	mailkite-php	Packagist
MailKite для Go	mailkite-go	Go modules
@mailkite/cli	mailkite-cli	npm
@mailkite/mcp (этот репозиторий)	mailkite-mcp	npm
@mailkite/client	mailkite-js	npm
@mailkite/expo	mailkite-expo	npm
MailKiteClient	mailkite-swift	Swift Package Manager
dev.mailkite:mailkite-client	mailkite-kotlin	Maven Central
mailkite_client	mailkite-flutter	pub.dev

Docs & links

📚 Документация: https://mailkite.dev/docs
📦 Руководство по этой библиотеке: https://mailkite.dev/docs/libraries#mcp
🤖 AI-агенты (MCP + inbox-агенты): https://mailkite.dev/docs/ai-agents
🌐 Сайт: https://mailkite.dev
🧭 Все библиотеки: https://mailkite.dev/docs/libraries