MCP-сервер SendHQ

Что это за сервер

MCP-сервер SendHQ позволяет ИИ-агенту управлять одним рабочим пространством SendHQ через Model Context Protocol: отправлять письма (по одному, пакетами, по шаблонам, ответами, с вложениями, с идемпотентными повторами), читать и искать отправленные и полученные письма (по темам, текстам и именам вложений) и их события доставки, раскладывать письма по меткам с правилами автосортировки, управлять черновиками и закрытыми вложениями, создавать и публиковать хранимые шаблоны, добавлять и подтверждать домены и их DNS, настраивать приём входящей почты и входящие адреса, анализировать доставляемость, отказы, жалобы и стоп-лист, а также читать данные об использовании аккаунта, состоянии оплаты, аналитику и метаданные API-ключей.

Это локальный stdio-сервер, встроенный в CLI-бинарник sendhq. Ваш MCP-клиент запускает sendhq mcp как дочерний процесс и общается с ним по JSON-RPC через stdin/stdout. Каждый вызов инструмента превращается в один документированный запрос к REST API SendHQ по адресу https://sendhq.cc/api/v1, аутентифицированный API-ключом вашего рабочего пространства, поэтому у MCP-сервера ровно те же права, что и у этого ключа, и не больше.

• 59 инструментов в 8 группах, сгенерированных из единого каталога, который также опубликован как tools.json.
• Строгие JSON Schema: неизвестные аргументы, неверные типы и отсутствующие обязательные поля отклоняются локально, до того как что-либо попадёт в SendHQ.
• Структурированные ошибки со стабильным code, HTTP-статусом status, пояснением explanation, конкретным способом исправления remedy и признаком того, поможет ли повторная попытка.
• Каждый инструмент, который отправляет реальные письма или удаляет данные, сообщает об этом в первых словах своего описания и снабжён аннотациями безопасности MCP.
• Режим --read-only скрывает все инструменты, которые отправляют письма или что-либо изменяют.
• Ничего не логируется. В stdout передаются только сообщения протокола; API-ключ и содержимое писем никогда не попадают в логи.

SendHQ в Claude и ChatGPT

Установка не нужна: SendHQ также запускает этот сервер как размещённый коннектор по адресу https://mcp.sendhq.cc/mcp с теми же инструментами. Вместо того чтобы вставлять ключ, вы входите в свой аккаунт SendHQ.

Claude

1. Откройте Settings → Connectors и найдите SendHQ в каталоге или выберите Add custom connector и вставьте https://mcp.sendhq.cc/mcp.
2. Нажмите Connect, войдите в SendHQ, проверьте запрашиваемый доступ и нажмите Allow.
3. Попросите Claude проверить ваш почтовый ящик, отправить письмо с вашего подтверждённого домена или объяснить причину отказа.

ChatGPT

1. Open Settings → Security and login and turn on Developer mode.
2. Go to chatgpt.com/plugins, click Create MCP app, name it SendHQ and enter https://mcp.sendhq.cc/mcp.
3. Sign in to SendHQ and click Allow, then pick SendHQ from the tools menu in a new chat.

Muse by Meta

In Muse, open Connectors and search for SendHQ. Click Connect, sign in to SendHQ and click Allow.

Подтверждение действий и отключение

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• Инструменты, которые отправляют реальные письма или удаляют данные, помечены соответствующим образом. Будет ли ассистент сначала спрашивать вас, настраивается для каждого инструмента в самом ассистенте: в Claude выберите Needs approval для этих инструментов в разделе Settings → Connectors → SendHQ.
• Коннектор получает собственный API-ключ, названный по имени ассистента (например, «Claude (AI connector)»). Удалите его в разделе API Keys, чтобы немедленно отключить коннектор.
• Он не может создавать или отзывать API-ключи и менять настройки оплаты. Вложения отправляются и возвращаются в base64; доступа к локальным файлам нет.
• Неоплаченные рабочие пространства (пробный период для интеграции) могут доставлять письма только на email аккаунта или на адрес симулятора AWS SES.

Вопросы: postmaster@sendhq.cc. Конфиденциальность: sendhq.cc/privacy.

Установка

Установите бинарник sendhq (Linux, macOS и Windows на x86-64 и arm64). Установщик проверяет контрольную сумму релиза и по умолчанию помещает бинарник в ~/.local/bin.

curl -fsSL https://downloads.sendhq.cc/install.sh | sh

irm https://downloads.sendhq.cc/install.ps1 | iex

sendhq version
SENDHQ_API_KEY=re_your_key sendhq doctor

Создайте API-ключ в панели управления по адресу https://sendhq.cc/app#/keys. MCP-сервер не умеет создавать ключи. Сервер запускается одной командой:

SENDHQ_API_KEY=re_your_key sendhq mcp

Обычно вручную её запускать не нужно: это делает MCP-клиент. Если запустить её в терминале, она будет ждать JSON-RPC на stdin.

Настройка клиента

Claude Code

claude mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

# read-only variant
claude mcp add sendhq-readonly --env SENDHQ_API_KEY=re_your_key -- sendhq mcp --read-only

Добавьте --scope user, чтобы сервер был доступен во всех проектах, или --scope project, чтобы записать его в .mcp.json проекта. Для общего .mcp.json берите ключ из переменной окружения, а не коммитьте его; Claude Code подставляет значения ${VAR} в .mcp.json.

{
  "mcpServers": {
    "sendhq": {
      "command": "sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "${SENDHQ_API_KEY}"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.sendhq]
command = "sendhq"
args = ["mcp"]
env = { SENDHQ_API_KEY = "re_your_key" }

Или из командной строки: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Отредактируйте claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) и перезапустите приложение. Десктопные приложения не наследуют PATH вашей оболочки, поэтому укажите абсолютный путь к бинарнику (which sendhq).

{
  "mcpServers": {
    "sendhq": {
      "command": "/Users/you/.local/bin/sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "re_your_key"
      }
    }
  }
}

Любой другой MCP-клиент

Настройте stdio-сервер с командой sendhq, аргументами ["mcp"] (при необходимости "--read-only") и переменными окружения, перечисленными ниже. Сервер поддерживает версии протокола MCP 2024-11-05, 2025-03-26, 2025-06-18 и 2025-11-25 и реализует initialize, ping, tools/list и tools/call. Результаты инструментов содержат и текстовый JSON-блок, и structuredContent.

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_health","arguments":{}}}

Размещённого HTTP-транспорта для сервера с доступом к аккаунту нет. Удалённому MCP-эндпоинту с правом записи потребовался бы OAuth для каждого пользователя, которого SendHQ не предлагает; локальный бинарник хранит ключ на той машине, где он и так уже есть.

Переменные окружения и флаги

Ключ передаётся только в заголовке Authorization: Bearer на настроенный базовый URL. Он никогда не выводится, не логируется, не повторяется в ошибках и не включается в результаты инструментов.

Модель безопасности для агентов

• Отправляет реальные письма. send_email, send_batch и send_template_test доставляют письма реальным людям и расходуют кредиты на доставку. Их описания начинаются с SENDS REAL EMAIL. Вызывайте их, только когда пользователь явно попросил отправить именно это письмо, подтвердив получателей, отправителя и содержание.
• Деструктивно. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox и remove_suppression помечены destructiveHint: true, а их описания начинаются с DESTRUCTIVE. Сначала получите подтверждение пользователя. remove_suppression ослабляет защитную блокировку и уместен, только когда человек подтвердил, что адрес снова работает.
• Изменяет состояние. Создание и изменение черновиков, шаблонов, доменов и почтовых ящиков, публикация шаблонов и запуск проверки меняют рабочее пространство, но не отправляют писем.
• Только чтение. Все остальные инструменты имеют readOnlyHint: true, и их можно свободно вызывать.
• Этот сервер никогда не меняет DNS. add_domain возвращает записи, которые должен опубликовать человек; get_domain_connect_link возвращает URL согласия, который человек должен открыть и одобрить у своего DNS-провайдера.
• Этот сервер никогда не меняет оплату. get_account только читает тариф, использование и состояние подписки.
• Неоплаченные рабочие пространства (пробный период для интеграции) могут доставлять письма только на email владельца аккаунта (get_account → user.email) или на адрес симулятора AWS SES, например success@simulator.amazonses.com, и не могут отправлять вложения.
• Принято — не значит доставлено. Успешная отправка возвращает ID; сведения о доставке, отказе и жалобе появляются позже в list_email_events. Никогда не утверждайте, что письмо попало во «Входящие» или что человек его прочитал.
• Не переключайтесь на другой адрес From, чтобы обойти приостановку 423, и никогда не добавляйте повторно получателей, которые отписались или пожаловались.

API-ключи вне зоны действия сервера

Намеренно нет инструментов, которые создают, изменяют, ротируют, отзывают или удаляют API-ключи. Агент не должен выпускать или уничтожать учётные данные. list_api_keys возвращает только имена, несекретные префиксы и время последнего использования. Управление ключами остаётся в панели управления за человеком, вошедшим в аккаунт.

Сценарии работы

1. Первая отправка

1. get_service_health подтверждает, что API доступен (работает без ключа).
2. get_account показывает тариф (access.tier), оставшуюся квоту и user.email. В пробном периоде этот email — единственный разрешённый реальный получатель.
3. list_sending_identities перечисляет адреса From, которые можно использовать. Если список пуст, сначала пройдите сценарий подключения домена.
4. Подтвердите с пользователем отправителя, получателя, тему и текст, затем вызовите send_email с idempotency_key.
5. list_email_events с возвращённым id покажет delivery, bounce, complaint или reject, как только провайдер сообщит результат (обычно от нескольких секунд до минут).

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "SendHQ is connected",
    "text": "It works.",
    "idempotency_key": "first-send-2026-09-26"
  }
}

2. Подтверждение домена от начала до конца

1. add_domain с name: "example.com". Результат содержит DNS-записи (CNAME для DKIM, подтверждение SES, SPF, рекомендуемый DMARC).
2. get_dns_provider с domain_id определяет авторитетного DNS-провайдера и возвращает точный относительный хост, который нужно указать для каждой записи у этого провайдера.
3. Если providers.domainConnect.available равно true, get_domain_connect_link возвращает URL согласия. Передайте его человеку: ничего не изменится, пока он не одобрит изменение у провайдера. В противном случае передайте человеку записи для публикации. Никогда не публикуйте вторую SPF-запись: добавьте include:amazonses.com в существующее значение v=spf1.
4. verify_domain повторно проверяет DNS и SES. Статус проходит через pending, checking и propagating до verified. Опрашивайте verify_domain или get_domain каждые 30–60 секунд; обновление DNS может занять от нескольких минут до нескольких часов.
5. Когда status становится verified, адреса домена появляются в list_sending_identities.

3. Отказы, жалобы и стоп-лист

1. list_blocked_recipients возвращает все заблокированные адреса с причиной (bounce, complaint, unsubscribe) и сводным количеством.
2. list_suppressions возвращает записи стоп-листа из-за жёстких отказов и жалоб; deliverability_stats даёт доли доставки, отказов и жалоб за 30 дней; list_sender_reputation показывает, какие адреса From ограничены или приостановлены.
3. Отправка, среди получателей которой есть адрес из стоп-листа, завершается ошибкой 422 recipient_suppressed. Уберите этого получателя и отправьте снова.
4. Вызывайте remove_suppression, только когда человек подтвердил, что ящик, давший отказ, теперь работает. Записи о жалобах в стоп-листе постоянны (409 complaint_suppression_locked).

4. Приём входящей почты

1. Домен (часто поддомен, например inbound.example.com) должен быть подтверждён.
2. setup_inbound настраивает приём и возвращает одну MX-запись. Её публикует человек.
3. Вызывайте verify_inbound, пока status не станет ready.
4. create_inbox с domain_id и local_part (например, support) создаёт support@inbound.example.com.
5. Опрашивайте list_emails с direction: "in" и unread: true (при необходимости с inbox_id). Читайте письмо через get_email, переписку — через get_thread, вложения — через download_attachment, а обработанное письмо отмечайте через mark_email (read: true).
6. Отвечайте в той же цепочке через send_email с reply_to_email_id; SendHQ сам выставит In-Reply-To, References и цепочку.

5. Вебхуки и уведомления о событиях

Сейчас SendHQ не предлагает настраиваемых клиентом вебхуков, поэтому инструмента для вебхуков нет. Уведомления провайдера обрабатываются внутри SendHQ и доступны через операции чтения. Вместо этого используйте опрос: list_email_events — для результата одного письма, list_emails со status (например, bounced) или after — для недавних изменений, list_emails с direction: "in" и unread: true — для новых входящих писем, list_blocked_recipients — для новых записей в стоп-листе. Опрашивайте не чаще примерно раза в минуту на каждый вопрос.

6. Диагностика сбоя доставки

1. Найдите письмо: list_emails с direction: "out" и to или query либо get_email, если ID известен. status: failed означает, что SendHQ или провайдер отклонили письмо при передаче; причина указана в ошибке письма.
2. list_email_events: bounce (постоянный или временный, с диагностикой провайдера), complaint, reject или delivery. Если событий ещё нет, провайдер пока не сообщил результат; подождите и проверьте снова.
3. Если завершился ошибкой сам вызов отправки, посмотрите code ошибки: sender_domain_unverified → завершите подтверждение домена; recipient_suppressed → адрес ранее дал жёсткий отказ или на него поступила жалоба; sender_paused → изучите list_sender_reputation и исправьте источник списка; trial_recipient_restricted → ограничения пробного периода; quota_exhausted → использование в get_account.
4. get_domain проверяет, что DKIM, SPF и DMARC по-прежнему опубликованы; deliverability_stats показывает, касается ли проблема одного письма или это тенденция.
5. Сообщайте то, что показывают факты. Событие delivery означает, что сервер получателя принял письмо, а не что оно попало во «Входящие» или было прочитано.

7. Собственная группа для задач (метки)

1. create_label с name (например, Agent/Orders) и skip_inbox: true. Это превращает метку в группу: полученные письма с этой меткой архивируются, поэтому отображаются только в метке и никогда — во «Входящих» человека.
2. Отправляйте письма по задачам через send_email (или send_batch) с labels: ["Agent/Orders"]. Ответы в этой переписке автоматически наследуют метку и минуют «Входящие».
3. Для писем, которые начинаются вне ваших переписок, добавьте правило сортировки: create_label_rule с inbox_id (выделенный адрес, например orders@…), from, to или subject. Передайте apply_to_existing: true, чтобы разложить уже полученные письма.
4. Работа с группой: list_emails с label: "Agent/Orders", direction: "in" и unread: true; читайте через get_email или get_thread, отвечайте через send_email с reply_to_email_id, а после обработки вызывайте mark_email с read: true.
5. Чтобы переместить случайно попавшее не туда письмо в группу или из неё, используйте label_email (add / remove). Добавление метки группы к полученному письму также архивирует его.
6. При необходимости set_inbox_forwarding отправляет копию всех писем, приходящих на адрес получения, в другой почтовый ящик (получатель сначала подтверждает это по email).

{
  "name": "send_email",
  "arguments": {
    "from": "Orders <orders@example.com>",
    "to": [
      "customer@example.net"
    ],
    "subject": "Order 1042: confirm delivery window",
    "text": "Reply with a time that works.",
    "labels": [
      "Agent/Orders"
    ],
    "idempotency_key": "order-1042-window"
  }
}

8. Вложения и шаблоны

На платном тарифе прикрепляйте до 10 файлов через attachments в send_email (для каждого нужен content_base64 или локальный file_path; filename по умолчанию — базовое имя файла). Для хранимых шаблонов: create_template → update_template_draft → render_template для предпросмотра на тестовых данных → send_template_test (отправляет одно реальное тестовое письмо) → publish_template, затем отправляйте через send_email или send_batch с template: {key, data} и ровно одним получателем в to.

Результаты, пагинация и ошибки

Успешный вызов возвращает JSON-объект API в виде structuredContent и в виде текстового JSON-блока. Каждый инструмент list_* принимает limit (1–200, по умолчанию 50) и offset и добавляет объект pagination. Продолжайте вызывать с offset: pagination.next_offset, пока has_more равно true.

{
  "data": [
    "…"
  ],
  "count": 50,
  "pagination": {
    "offset": 0,
    "limit": 50,
    "returned": 50,
    "total": 180,
    "has_more": true,
    "next_offset": 50
  }
}

Неудачный вызов возвращает isError: true со структурированной ошибкой. Следуйте remedy, а не повторяйте вслепую; повторяйте, только если retryable равно true.

{
  "error": {
    "code": "trial_recipient_restricted",
    "status": 402,
    "message": "The integration trial can deliver only to your account email or an AWS SES simulator address",
    "retryable": false,
    "explanation": "This workspace is on the unpaid integration trial. Trial sends can be delivered only to the account owner's email address or an AWS SES simulator address.",
    "remedy": "Send to the account email (get_account -> user.email) or a simulator address such as success@simulator.amazonses.com to test. To email anyone else, the account owner must activate a paid plan in the dashboard (Profile & Billing). Do not retry the same recipients."
  }
}

Необязательные поля ошибки: request_id (сообщите его в поддержку), retry_after_seconds, problems (список нарушений схемы для invalid_arguments) и idempotent_replayed (см. раздел «Идемпотентность»).

Идемпотентность

send_email и send_batch принимают idempotency_key (не более 200 символов), который передаётся в заголовке Idempotency-Key. Создавайте один стабильный ключ на каждое логическое письмо, например invoice-4812-receipt.

• При повторе нужно использовать тот же ключ И идентичное тело запроса. Тот же ключ с любым изменением (получатель, тема, текст, заголовок, данные шаблона, даже значения аргументов) возвращает 409 idempotency_conflict.
• Тот же ключ, то же тело, исходный запрос завершён: SendHQ возвращает сохранённый результат без повторной отправки. Так можно безопасно повторить запрос после тайм-аута или network_error.
• Тот же ключ, пока исходный запрос ещё выполняется: 409 idempotency_in_progress, можно повторить после короткого ожидания.
• Для нового логического письма нужен новый ключ.
• Сохранённые ошибки тоже воспроизводятся. Если первая попытка завершилась ошибкой, повтор с тем же ключом вернёт ту же ошибку с idempotent_replayed: true и retryable: false. Проверьте через list_emails (direction: out), что ничего не ушло, устраните причину и отправьте с новым ключом.
• Сервер никогда сам не повторяет POST-запросы. Автоматически повторяются только GET-запросы на чтение (до 3 попыток при сетевых ошибках, 429 и 5xx).
• send_email со встроенными attachments не принимает idempotency_key, потому что выполняет несколько запросов. Для безопасной с точки зрения повторов отправки вложений: create_draft → upload_attachment → send_email с draft_id и idempotency_key.

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <billing@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Receipt #4812",
    "text": "Thanks for your payment.",
    "idempotency_key": "receipt-4812"
  }
}

Лимиты запросов и квоты

SendHQ не публикует фиксированный лимит запросов в секунду для API. На практике агент сталкивается с лимитами использования, которые возвращаются как 429:

• Месячный лимит доставок получателям по тарифу. Каждый адрес в To, Cc и Bcc считается одной доставкой. См. get_account → usage.recipientDeliveries в сравнении с usage.emailQuotaMonth.
• Дневной лимит получателей для конкретного адреса From, который задаётся состоянием репутации этого отправителя (list_sender_reputation → dailyLimit, по умолчанию 2 000 на платных тарифах).
• Пробный период для интеграции: всего 100 получателей и только на email аккаунта или адреса симулятора SES.
• Вложения: не более 10 файлов и 10 МБ на письмо; 10 ГБ передачи вложений в месяц с учётом числа получателей на платных тарифах.
• На один запрос: To + Cc + Bcc — до 100 адресов; send_batch — до 100 писем.
• Репутационный предохранитель: если в скользящем 7-дневном окне отказы или жалобы превышают порог, отправка с конкретного адреса From ограничивается или приостанавливается (423 sender_paused). Когда показатели снижаются, адрес восстанавливается автоматически.

quota_exhausted нельзя повторять, пока не начнётся новый период или не сменится тариф. rate_limited можно повторить через retry_after_seconds; для отправок повторяйте с тем же idempotency_key и идентичным телом.

Каталог ошибок

code стабилен; ветвите логику по нему, а не по message.

Справочник инструментов

Все инструменты с классом безопасности, вызываемым REST-эндпоинтом, параметрами, форматом ответа и примером объекта параметров tools/call. Параметры указаны точно: сервер отклоняет всё, чего нет в списке.

Письма и цепочки: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Метки и правила автосортировки: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Черновики, вложения и адреса отправителя: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Хранимые шаблоны: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Домены и DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
Входящая почта: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Доставляемость, отказы и стоп-лист: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Аккаунт, использование, аналитика и ключи: get_account, get_analytics, list_api_keys, get_service_health

Нет инструментов, подходящих под этот фильтр.

Письма и цепочки

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Your export is ready",
    "text": "Download it from your dashboard.",
    "idempotency_key": "export-ready-42"
  }
}

{
  "name": "send_batch",
  "arguments": {
    "emails": [
      {
        "from": "Acme <hello@example.com>",
        "to": [
          "owner@example.com"
        ],
        "template": {
          "key": "account-welcome",
          "data": {
            "first_name": "Asha"
          }
        }
      }
    ],
    "idempotency_key": "welcome-batch-2026-09-26"
  }
}

{
  "name": "list_emails",
  "arguments": {
    "direction": "in",
    "unread": true,
    "limit": 25
  }
}

{
  "name": "get_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "mark_email",
  "arguments": {
    "email_id": "em_123",
    "read": true
  }
}

{
  "name": "delete_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "list_email_events",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "get_thread",
  "arguments": {
    "thread_id": "em_123"
  }
}

Метки и правила автосортировки

{
  "name": "list_labels",
  "arguments": {}
}

{
  "name": "get_label",
  "arguments": {
    "label_id": "Billing"
  }
}

{
  "name": "create_label",
  "arguments": {
    "name": "Agent/Orders",
    "skip_inbox": true,
    "rules": [
      {
        "from": "@stripe.com"
      }
    ]
  }
}

{
  "name": "update_label",
  "arguments": {
    "label_id": "lbl_123",
    "name": "Finance/Billing"
  }
}

{
  "name": "delete_label",
  "arguments": {
    "label_id": "lbl_123"
  }
}

{
  "name": "create_label_rule",
  "arguments": {
    "label_id": "Billing",
    "inbox_id": "inb_123",
    "skip_inbox": true
  }
}

{
  "name": "delete_label_rule",
  "arguments": {
    "label_id": "lbl_123",
    "rule_id": "lrule_123"
  }
}

{
  "name": "label_email",
  "arguments": {
    "email_id": "em_123",
    "add": [
      "Billing"
    ],
    "remove": [
      "Support"
    ]
  }
}

Черновики, вложения и адреса отправителя

{
  "name": "list_sending_identities",
  "arguments": {}
}

{
  "name": "create_draft",
  "arguments": {
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice"
  }
}

{
  "name": "list_drafts",
  "arguments": {}
}

{
  "name": "get_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "update_draft",
  "arguments": {
    "draft_id": "dr_123",
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice (updated)",
    "text": "Attached."
  }
}

{
  "name": "delete_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "upload_attachment",
  "arguments": {
    "draft_id": "dr_123",
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "file_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "download_attachment",
  "arguments": {
    "attachment_id": "att_123",
    "save_to_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "delete_attachment",
  "arguments": {
    "attachment_id": "att_123"
  }
}

Хранимые шаблоны

{
  "name": "list_templates",
  "arguments": {
    "lifecycle": "active"
  }
}

{
  "name": "create_template",
  "arguments": {
    "name": "Account welcome",
    "key": "account-welcome",
    "starter": "welcome"
  }
}

{
  "name": "get_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "update_template_draft",
  "arguments": {
    "template_id": "account-welcome",
    "revision": 3,
    "name": "Account welcome",
    "subject_template": "Welcome, {{first_name}}",
    "text_template": "Hi {{first_name}}",
    "variables": [
      {
        "key": "first_name",
        "type": "text",
        "required": true
      }
    ],
    "sample_data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "create_template_draft",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "render_template",
  "arguments": {
    "template_id": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "send_template_test",
  "arguments": {
    "template_id": "account-welcome",
    "to": [
      "owner@example.com"
    ]
  }
}

{
  "name": "publish_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "archive_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "restore_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

Домены и DNS

{
  "name": "list_domains",
  "arguments": {}
}

{
  "name": "get_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "add_domain",
  "arguments": {
    "name": "example.com"
  }
}

{
  "name": "verify_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "delete_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_dns_provider",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_domain_connect_link",
  "arguments": {
    "domain_id": "dom_123"
  }
}

Входящая почта

{
  "name": "setup_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "verify_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "list_inboxes",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

{
  "name": "create_inbox",
  "arguments": {
    "domain_id": "dom_123",
    "local_part": "support",
    "name": "Support"
  }
}

{
  "name": "update_inbox",
  "arguments": {
    "inbox_id": "inb_123",
    "status": "disabled"
  }
}

{
  "name": "set_inbox_forwarding",
  "arguments": {
    "inbox_id": "inb_123",
    "forward_to": "team@example.net"
  }
}

{
  "name": "delete_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

Доставляемость, отказы и стоп-лист

{
  "name": "deliverability_stats",
  "arguments": {}
}

{
  "name": "list_sender_reputation",
  "arguments": {}
}

{
  "name": "list_suppressions",
  "arguments": {}
}

{
  "name": "remove_suppression",
  "arguments": {
    "email": "fixed-mailbox@example.net"
  }
}

{
  "name": "list_blocked_recipients",
  "arguments": {}
}

Аккаунт, использование, аналитика и ключи

{
  "name": "get_account",
  "arguments": {}
}

{
  "name": "get_analytics",
  "arguments": {
    "days": 30
  }
}

{
  "name": "list_api_keys",
  "arguments": {}
}

{
  "name": "get_service_health",
  "arguments": {}
}

Покрытие API

Все операции публичного API и инструменты, которые их покрывают. Покрыто всё, что пользователь может сделать в панели управления и для чего есть API; перечисленные ниже исключения сделаны намеренно.

Намеренно недоступно

Машиночитаемый каталог: /docs/mcp/tools.json (схемы, аннотации, соответствие эндпоинтам, исключения). Версия этой страницы в Markdown: /docs/mcp.md. Если установлен CLI, команда sendhq commands --format json выводит тот же каталог.