SendHQ MCP 服务器

这个服务器是什么

SendHQ MCP 服务器让 AI 智能体通过 Model Context Protocol 操作一个 SendHQ 工作区：发送邮件（单封、批量、基于模板、回复、附件、幂等重试），读取和搜索已发送及已收到的邮件（主题、正文和附件名称）及其投递事件，使用自动归档规则将邮件整理到标签中，管理草稿和私有附件，编写并发布托管模板，添加并验证域名及其 DNS，配置入站收信和入站地址，查看送达率、退信、投诉和抑制记录，以及读取账户用量、计费状态、分析数据和 API 密钥元数据。

它是一个内置在 sendhq CLI 二进制文件中的本地 stdio 服务器。您的 MCP 客户端会以子进程方式启动 sendhq mcp，并通过 stdin/stdout 使用 JSON-RPC 通信。每一次工具调用都会变成一个对 https://sendhq.cc/api/v1 上 SendHQ REST API 的有文档记录的请求，并使用您的工作区 API 密钥进行身份验证，因此 MCP 服务器拥有的权限与该密钥完全一致，不多也不少。

• 59 个工具，分为 8 组，均由同一份目录生成，该目录也以 tools.json 的形式公开发布。
• 严格的 JSON Schema：未知参数、类型错误和缺少必填字段都会在本地被拒绝，不会有任何请求到达 SendHQ。
• 结构化错误，包含稳定的 code、HTTP status、explanation（说明）、具体的 remedy（补救措施），以及重试是否有帮助。
• 每个会发送真实邮件或销毁数据的工具，都会在其描述的开头明确说明，并带有 MCP 安全注解。
• --read-only 模式会隐藏所有发送类和修改类工具。
• 不记录任何日志。stdout 只传输协议消息；API 密钥和邮件内容永远不会进入日志。

在 Claude 和 ChatGPT 中使用 SendHQ

无需安装：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 中，前往 Settings → Connectors → SendHQ，为这些工具选择 Needs approval。
• 连接器会获得一个独立的 API 密钥，并以助手命名（例如“Claude (AI connector)”）。在 API Keys 中删除该密钥即可立即断开连接。
• 它不能创建或吊销 API 密钥，也不能更改计费设置。附件以 base64 形式发送和返回；它无法访问本地文件。
• 未付费的工作区（集成试用）只能投递到账户邮箱或 AWS SES 模拟器地址。

如有疑问：postmaster@sendhq.cc。隐私政策：sendhq.cc/privacy。

安装

安装 sendhq 二进制文件（支持 x86-64 和 arm64 上的 Linux、macOS 和 Windows）。安装程序会校验发布版本的校验和，并默认将二进制文件放到 ~/.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

在控制台的 https://sendhq.cc/app#/keys 创建 API 密钥。MCP 服务器无法创建密钥。运行服务器只需要这一条命令：

SENDHQ_API_KEY=re_your_key sendhq mcp

通常您不需要手动运行它：MCP 客户端会负责启动。在终端中运行时，它会等待 stdin 上的 JSON-RPC 输入。

配置您的客户端

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 会展开 .mcp.json 中的 ${VAR}。

{
  "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\），然后重启应用。桌面应用不会继承 shell 的 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 请求头发送到配置的 base 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 只读取套餐、用量和订阅状态。
• 未付费的工作区（集成试用）只能投递到账户所有者的邮箱（get_account → user.email）或 AWS SES 模拟器地址（例如 success@simulator.amazonses.com），并且不能发送附件。
• 已受理不等于已送达。发送成功会返回一个 ID；投递、退信和投诉的证据会稍后出现在 list_email_events 中。切勿声称邮件已进入收件箱或某人已阅读了邮件。
• 不要为了绕过 423 暂停而换用其他 From 地址，也绝不要重新添加已退订或已投诉的收件人。

API 密钥不在范围之内

按照设计，没有任何工具可以创建、修改、轮换、吊销或删除 API 密钥。智能体不得生成或销毁凭据。list_api_keys 只返回名称、非机密的前缀和最近使用时间。密钥管理始终留在控制台中，由已登录的人来完成。

工作流

1. 首次发送

1. get_service_health 确认 API 可以访问（无需密钥即可使用）。
2. get_account 显示套餐（access.tier）、剩余配额和 user.email。在试用期内，该邮箱是唯一允许的真实收件人。
3. list_sending_identities 列出您可以使用的 From 地址。如果列表为空，请先完成域名工作流。
4. 与用户确认发件人、收件人、主题和正文，然后带上 idempotency_key 调用 send_email。
5. 一旦服务商上报结果（通常在几秒到几分钟内），使用返回的 id 调用 list_email_events，即可看到 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. 使用 name: "example.com" 调用 add_domain。结果中包含 DNS 记录（DKIM CNAME、SES 验证、SPF、推荐的 DMARC）。
2. 使用 domain_id 调用 get_dns_provider，会检测权威 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。请每 30–60 秒轮询一次 verify_domain 或 get_domain；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. 使用 domain_id 和 local_part（例如 support）调用 create_inbox，即可创建 support@inbound.example.com。
5. 使用 direction: "in" 和 unread: true（可选加上 inbox_id）轮询 list_emails。使用 get_email 读取邮件，使用 get_thread 读取其会话，使用 download_attachment 下载附件，并使用 mark_email（read: true）将其标记为已处理。
6. 使用 send_email 并带上 reply_to_email_id 在会话中回复；SendHQ 会设置 In-Reply-To、References 和会话。

5. Webhook 与事件通知

SendHQ 目前不提供可由客户配置的 Webhook，因此没有 Webhook 工具。服务商通知在 SendHQ 内部处理，并通过读取接口对外提供。请改用轮询：用 list_email_events 查看单封邮件的结果；用带 status（例如 bounced）或 after 的 list_emails 查看最近的变化；用带 direction: "in" 和 unread: true 的 list_emails 查看新的入站邮件；用 list_blocked_recipients 查看新的抑制记录。针对每个问题，轮询频率不要超过大约每分钟一次。

6. 诊断投递失败

1. 找到这封邮件：使用 direction: "out" 加上 to 或 query 调用 list_emails；如果您有 ID，则调用 get_email。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. 使用 name（例如 Agent/Orders）和 skip_inbox: true 调用 create_label。这样该标签就成为一个分类：收到的邮件一旦获得该标签就会被归档，因此只会出现在该标签中，永远不会出现在人类用户的收件箱里。
2. 使用 send_email（或 send_batch）并带上 labels: ["Agent/Orders"] 发送任务邮件。该会话的回复会自动继承该标签，并跳过收件箱。
3. 对于并非起始于您的会话的邮件，请添加归档规则：使用 inbox_id（一个专用地址，例如 orders@…）、from、to 或 subject 调用 create_label_rule。传入 apply_to_existing: true 可同时归档已收到的邮件。
4. 处理分类中的邮件：使用 label: "Agent/Orders"、direction: "in" 和 unread: true 调用 list_emails；使用 get_email 或 get_thread 读取，使用 send_email 并带上 reply_to_email_id 回复，处理完毕后调用 mark_email 并设置 read: true。
5. 使用 label_email（add / remove）将放错位置的邮件移入或移出。为收到的邮件添加分类标签时，也会将其归档。
6. 此外，还可以使用 set_inbox_forwarding 将某个收件地址收到的所有邮件抄送一份到另一个邮箱（目标邮箱需要先通过邮件确认）。

{
  "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. 附件与模板

在付费套餐下，可通过 send_email 的 attachments 最多附加 10 个文件（每个文件需要提供 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 收件人进行发送。

结果、分页与错误

调用成功时，会将 API 的 JSON 对象同时作为 structuredContent 和 JSON 文本块返回。每个 list_* 工具都接受 limit（1–200，默认 50）和 offset，并附加一个 pagination 对象。只要 has_more 为 true，就继续使用 offset: pagination.next_offset 调用。

{
  "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 对应的 schema 违规列表）以及 idempotent_replayed（参见“幂等”）。

幂等

send_email 和 send_batch 接受 idempotency_key（最多 200 个字符），并以 Idempotency-Key 请求头发送。请为每封逻辑邮件生成一个稳定的 key，例如 invoice-4812-receipt。

• 重试时必须使用相同的 key，并且请求体完全相同。同一个 key 下出现任何变化（收件人、主题、正文、邮件头、模板数据，甚至参数值）都会返回 409 idempotency_conflict。
• 相同的 key、相同的请求体，且原请求已完成：SendHQ 会返回已存储的结果，而不会再次发送。这就是在超时或 network_error 之后安全重试的方法。
• 原请求仍在处理中时使用相同的 key：返回 409 idempotency_in_progress，稍等片刻后可重试。
• 新的逻辑邮件需要新的 key。
• 已存储的失败结果同样会被重放。如果第一次尝试失败，使用相同 key 重试会返回同样的失败，并带有 idempotent_replayed: true 和 retryable: false。请检查 list_emails（direction: out）确认没有邮件发出，修复问题根源，然后使用一个新的 key 发送。
• 服务器从不自行重试 POST 请求。只有只读的 GET 调用会被自动重试（在网络错误、429 和 5xx 时最多尝试 3 次）。
• 带有内联 attachments 的 send_email 不能使用 idempotency_key，因为它会执行多个请求。要实现可安全重试的附件发送，请按以下流程：create_draft → upload_attachment → 使用 draft_id 和 idempotency_key 调用 send_email。

{
  "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 个收件人，且只能发送到账户邮箱或 SES 模拟器地址。
• 附件：每封邮件最多 10 个文件、10 MB；付费套餐每月有 10 GB 按收件人加权计算的附件传输量。
• 单次请求：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（包含 schema、注解、端点映射和排除项）。本页的 Markdown 版本：/docs/mcp.md。安装 CLI 后，运行 sendhq commands --format json 会输出同一份目录。