内容
# @poststack.dev/mcp
PostStack 模型上下文协议服务器，用于 [PostStack](https://poststack.dev) 电子邮件 API — 一个 [欧盟托管，符合GDPR](https://poststack.dev/security) 的 [AI代理电子邮件API](https://poststack.dev/docs/mcp)。让像 Claude、Cursor 和 Windsurf 这样的助手发送事务性电子邮件、从 inbound 线程中草拟回复、运行可送达性检查、总结广播等 — 通过一个精选的工具界面。
102 个工具，5 个提示和 5 个资源，所有这些都通过本地 stdio 二进制或托管的 HTTP 传输在 `https://api.poststack.dev/mcp` 上提供。
完整的 MCP 参考资料：[poststack.dev/docs/mcp](https://poststack.dev/docs/mcp)。
## 快速入门
### 托管（Claude.ai 连接器，托管代理）
将任何 MCP 客户端指向：
```
https://api.poststack.dev/mcp
```
使用您的 PostStack API 密钥作为 Bearer 令牌进行身份验证。不需要本地安装。
### Claude Desktop（stdio）
```json
{
"mcpServers": {
"poststack": {
"command": "npx",
"args": ["-y", "@poststack.dev/mcp"],
"env": {
"POSTSTACK_API_KEY": "sk_live_your_api_key_here"
}
}
}
}
```
配置文件位置：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
您也可以使用以下命令生成代码片段：
```bash
npx @poststack.dev/mcp --print-config claude-desktop
```
### Claude 代码
```bash
claude mcp add poststack -e POSTSTACK_API_KEY=sk_live_your_api_key_here -- npx -y @poststack.dev/mcp
```
### Cursor / VS Code
与 Claude Desktop 相同的 JSON 结构，在编辑器的 MCP 设置中。
## 环境变量
| 变量 | 是否必需 | 描述 |
| --- | --- | --- |
| `POSTSTACK_API_KEY` | 是 | PostStack API 密钥（`sk_live_…` 或 `sk_test_…`） |
| `POSTSTACK_MCP_TRACE` | 否 | 设置为 `1` 以向 stderr 发出每个工具调用的 NDJSON 遥测数据 |
## 代理获取的内容
MCP 服务器不仅仅镜像 REST API — 它为代理提供所需的上下文工具，以做出明智的决定：在发送之前进行垃圾邮件检查，在选择发件地址之前进行可送达性摘要，在重新参与联系人之前进行参与度评分。
### 示例：欢迎电子邮件
`draft_welcome_email` 提示引导代理草拟并发送个性化的欢迎电子邮件给新联系人。查找联系人，选取已发布的欢迎模板，渲染它，检查语法，然后发送。
其他提示涵盖重新参与、跟进非点击者的活动、广播摘要和入站分类。
## 参考
<!-- TOOLS:START -->
### 工具（102）
#### 电子邮件
- `send_email` — 立即发送一封单独的事务性电子邮件，或安排在未来某个时间发送。
- `send_batch_emails` — 在单个批量请求中发送多封电子邮件（每次调用最多 100 封）。
- `list_emails` — 列出以前发送的电子邮件，带有可选的筛选器和分页。
- `get_email` — 获取特定电子邮件的完整详细信息和事件时间线， 按 ID。
- `cancel_email` — 取消尚未进入发送管道的已计划电子邮件。
- `reschedule_email` — 将已计划的电子邮件重新安排到新的发送时间。
- `lint_email` — 对草稿电子邮件运行Rspamd支持的垃圾邮件预检，并返回分数、操作和每个规则的符号。
- `preview_email` — 渲染 + 检查 + 度量电子邮件，一次性完成，无需发送。
#### 电子邮件验证
- `validate_email` — 在创建联系人或发送电子邮件之前，检查电子邮件地址是否安全发送。
- `validate_email_batch` — 验证最多 100 个电子邮件地址的批量请求。与 `validate_email` 每个地址的检查相同。
#### 联系人
- `create_contact` — 创建一个新的联系人（可以接收电子邮件/广播的人）。
- `list_contacts` — 列出联系人，带有可选的搜索和分段筛选。
- `get_contact` — 获取联系人的完整详细信息，按 ID。
- `update_contact` — 更新现有联系人的姓名、属性或订阅状态。
- `delete_contact` — 永久删除联系人（不可逆转 — 使用 unsubscribe_contact 进行退出）。
- `unsubscribe_contact` — 将联系人标记为取消订阅所有电子邮件（保留联系人记录）。
- `get_contact_by_email` — 按电子邮件地址查找联系人。
- `get_contact_activity` — 获取联系人的最近电子邮件事件时间线，按事件类型分组（已发送/已投递/已打开/已点击/已退回/已投诉/失败）。
- `get_engagement_summary` — 获取单个联系人的参与度摘要：分段 + 生命周期计数 + 打开/点击率 + 最近打开/点击 + 顶部标签。
- `search_contacts` — 搜索联系人，带有筛选器（分段、参与度、取消订阅）和模糊查询，跨越电子邮件/名字/姓氏。每个行上添加一个 `match_reason`，指示哪个字段与查询匹配。
#### 模板
- `create_template` — 创建一个新的电子邮件模板，带有 {{variable}} 占位符。
- `list_templates` — 列出电子邮件模板。
- `get_template` — 获取模板的完整正文、主题和变量。
- `update_template` — 更新现有模板的名称、主题、正文或变量列表。
- `delete_template` — 永久删除模板（不可逆转）。
- `publish_template` — 标记模板为已发布，以便可以被 `send_email` 引用。
- `unpublish_template` — 标记模板为未发布，以便不能被发送。
- `duplicate_template` — 创建现有模板的副本（新 ID，相同正文，名称后缀 "(copy)"）。
- `render_template` — 服务器端渲染模板，带有提供的变量。
#### 广播
- `create_broadcast` — 创建针对某个分段的广播草稿。
- `list_broadcasts` — 列出广播。
- `get_broadcast` — 获取广播的详细信息和聚合投递统计数据。
- `update_broadcast` — 编辑广播草稿。仅草稿广播可以更新。
- `send_broadcast` — 立即向分段发送广播草稿。
- `cancel_broadcast` — 取消排队或正在发送的广播。
- `broadcast_performance` — 获取广播性能 — 对于单个广播（如果适用，则为变体分解）或按选定指标排名的排行榜。
- `find_non_clickers` — 列出接收了广播但未点击任何跟踪链接的联系人。
#### 分段
- `create_segment` — 创建静态联系人分段（手动管理的列表）。
- `list_segments` — 列出联系人分段。
- `get_segment` — 获取分段的详细信息和成员数量。
- `update_segment` — 重命名现有分段。
- `delete_segment` — 删除分段定义。分段中的联系人不会被删除。
- `add_contacts_to_segment` — 将一个或多个联系人添加到分段。
- `remove_contact_from_segment` — 从分段中删除单个联系人。
#### 工作流
- `list_workflows` — 列出为此团队定义的所有工作流（事件触发的自动化管道）。
- `get_workflow` — 获取工作流的完整详细信息，包括其有序步骤。
- `create_workflow` — 创建新的工作流壳（暂无步骤，状态为草稿）。
- `update_workflow` — 更新工作流的名称、触发器类型或触发器配置。
- `delete_workflow` — 永久删除工作流及其步骤。正在进行的操作不会被取消 — 它们将在实时引擎上完成。
- `add_workflow_step` — 将步骤追加（或插入）到工作流中。
- `update_workflow_step` — 更新步骤的配置。不能更改 `step_type` 或位置 — 删除并重新添加。
- `remove_workflow_step` — 从工作流中删除步骤。剩余的步骤保持其位置（允许有间隙）。
- `activate_workflow` — 将工作流从草稿/暂停状态移动到活动状态，以便新的触发器事件启动操作。
- `pause_workflow` — 暂停活动工作流，以便新的触发器事件 不 启动操作。正在进行的操作继续完成。
- `trigger_workflow` — 手动为特定联系人触发工作流。适用于任何 `trigger_type`，但对“手动”工作流最有用。
#### 注册表单
- `list_signup_forms` — 列出可嵌入的注册表单。
- `get_signup_form` — 获取注册表单的完整详细信息，包括其字段、目标分段和提交计数。
- `create_signup_form` — 创建可嵌入的注册表单。提交内容会创建联系人，并可选地将他们添加到分段/订阅主题中。
- `update_signup_form` — 更新注册表单的字段、目标分段/主题、消息或活动状态。
- `delete_signup_form` — 永久删除注册表单。现有页面上的嵌入式副本将失败，返回 404。
#### 域名
- `create_domain` — 将新的发送域名添加到 PostStack。
- `list_domains` — 列出发送域名。
- `get_domain` — 获取域名详细信息，包括 DNS 记录和验证状态。
- `verify_domain` — 触发域名的 DNS 验证。
- `update_domain` — 更新域名设置（跟踪、TLS、入站、BIMI、发送流）。
- `delete_domain` — 永久删除发送域名（不可逆转 — 历史邮件记录保留）。
- `check_deliverability` — 检查发件地址当前是否安全发送。
#### 邮箱
- `create_mailbox` — 在验证的域名上提供邮箱（IMAP/SMTP 收件箱）。
- `list_mailboxes` — 列出所有域名下的邮箱。
- `get_mailbox` — 获取邮箱的元数据（状态、配额、最后登录）。
- `update_mailbox` — 更新邮箱的显示名称、配额、状态或 webhook 设置。
- `delete_mailbox` — 永久删除邮箱和所有存储的邮件。
- `change_mailbox_password` — 重置邮箱的 IMAP/SMTP 密码。
- `suggest_from_address` — 建议适合给定目的的发件地址，从团队的验证域名 + 现有邮箱中提取。
#### 入站电子邮件
- `list_inbound_emails` — 列出此账户中邮箱接收的入站电子邮件。
- `get_inbound_email` — 获取接收的入站电子邮件的完整标头和正文。
- `list_inbound_email_attachments` — 列出入站电子邮件的附件（文件名、大小、contentType）。
- `reply_to_inbound_email` — 回复入站电子邮件（自动设置主题和线程标头）。
- `forward_inbound_email` — 将入站电子邮件转发给其他收件人，带有可选的封面便条。
- `draft_from_thread` — 为入站电子邮件构建回复草稿骨架 — 正确的线程、引用原始内容、问候/签名、建议的发件地址和主题。启发式；代理填写正文。
#### webhook
- `create_webhook` — 订阅 URL 以通过签名的 POST 请求接收事件通知。
- `list_webhooks` — 列出配置的 webhook 端点。
- `get_webhook` — 获取 webhook 的详细信息。
- `update_webhook` — 编辑 webhook 的 URL、事件列表或启用状态。
- `delete_webhook` — 永久删除 webhook 端点。
#### 订阅主题
- `create_subscription_topic` — 创建订阅主题（命名为“产品更新”）。
- `list_subscription_topics` — 列出此账户定义的所有订阅主题。
- `delete_subscription_topic` — 永久删除订阅主题。订阅被删除。
- `get_contact_subscriptions` — 列出联系人当前订阅的主题。
- `subscribe_contact_to_topic` — 将联系人订阅到订阅主题。
- `unsubscribe_contact_from_topic` — 将联系人取消订阅订阅主题。
#### 联系人属性
- `create_contact_property` — 定义自定义联系人属性（联系人属性字段的 typed 架构）。
- `list_contact_properties` — 列出此账户定义的所有自定义联系人属性。
- `update_contact_property` — 编辑自定义联系人属性的标签、选项或必填标志。
- `delete_contact_property` — 删除自定义联系人属性定义。现有的联系人属性值被删除。
#### 抑制
- `list_suppressions` — 列出被抑制的电子邮件地址（将不会收到任何电子邮件）。
- `add_suppression` — 阻止电子邮件地址接收任何未来的发送。
- `remove_suppression` — 从抑制列表中删除地址（将恢复发送）。
#### API 密钥
- `create_api_key` — 生成新的 PostStack API 密钥。完整的密钥仅在此响应中返回一次，之后无法检索。
- `list_api_keys` — 列出 API 密钥（仅返回前缀，从不返回完整的密钥）。
- `get_api_key` — 获取 API 密钥的元数据（密钥永不被返回）。
- `revoke_api_key` — 永久吊销 API 密钥 — 使用它的所有后续请求都将失败。
### 提示（5）
- `draft_welcome_email` — 引导代理草拟并发送个性化的欢迎电子邮件给新联系人。查找联系人，选取已发布的欢迎模板，渲染它，检查语法，然后发送。
- `reengage_dormant` — 查找休眠联系人并草拟重新参与活动。拉取休眠分段，选取退出友好的模板，并为审阅准备广播。
- `followup_non_clickers` — 演示 B 路径 — 查找最近广播中表现最佳的广播，识别未点击的收件人，并草拟后续跟进。
- `summarize_campaign` — 为广播生成简短的性能报告：头部指标、适用的 A/B 赢家和一行建议。
- `triage_inbound` — 读取入站电子邮件，分类（支持/销售/账单/垃圾邮件/其他），并提出下一步行动。如果合适，草拟回复骨架。
### 资源（5）
- `poststack://templates` — 已认证团队的所有电子邮件模板列表。包括 ID、名称、主题、版本、已发布标志。
- `poststack://templates/{id}` — 按 publicId 获取单个模板 — 完整的正文、主题、变量。
- `poststack://domains` — 已认证团队的发送域名列表 — 名称、状态、DNS 记录、跟踪标志。
- `poststack://segments` — 已认证团队的联系人分段列表 — ID、名称、联系人数量。
- `poststack://brand` — 已认证的团队身份 + 默认发送建议。包括团队名称、验证的域名数量和从现有邮箱派生的推荐发件地址。
<!-- TOOLS:END -->
## 链接
- [PostStack — 欧盟电子邮件 API](https://poststack.dev)
- [MCP 服务器文档](https://poststack.dev/docs/mcp) — 完整的工具 / 提示 / 资源参考
- [托管 MCP 传输](https://api.poststack.dev/mcp) — 无需本地安装
- [TypeScript SDK](https://poststack.dev/docs/sdk) · [REST API](https://poststack.dev/docs)
- [定价](https://poststack.dev/pricing) — 免费 3,000 封电子邮件/月
- [状态](https://poststack.dev/status) · [安全](https://poststack.dev/security)
## 许可证
MIT — 见 [LICENSE](./LICENSE)。
