Sendsets

Sendsets：面向 AI Agent 的冷邮件 API

Sendsets 为 AI Agent 提供可编程的冷邮件功能。Agent（Claude Code、Codex、Cursor、Gemini CLI、ChatGPT，或你自己的代码）可以通过 MCP 服务、CLI 或 REST API 连接发信邮箱、预热邮箱、创建并启动外发营销活动、添加潜在客户，以及读取和回复邮件，而无需使用销售仪表板。

此仓库是 Sendsets 面向公众和 Agent 的入口：

内容	位置
远程 MCP 服务	https://api.sendsetsapi.com/v1/mcp（可流式传输的 HTTP，OAuth 2.1 或 API 密钥）
Agent 技能（SKILL.md）	skills/send-cold-email、skills/sendsets、skills/sendsets-cli
Claude Code 插件市场	.claude-plugin/marketplace.json
Codex 插件市场	.agents/plugins/marketplace.json、.codex-plugin/plugin.json
Agent Plugins 清单	plugin.json、mcp.json（agent-plugins.org）
Gemini CLI 扩展	gemini-extension.json
MCP Registry 清单	server.json（io.github.AddisonHoff/sendsets）
OpenAPI 3.1 规范	openapi.json
文档	docs.sendsetsapi.com

在 app.sendsetsapi.com 注册。最多可免费使用 10 个邮箱。

Agent 可以用它做什么

MCP 服务和 REST API 暴露相同的服务层工具。凭证可访问的内容取决于授予它的权限范围。

• 营销活动：创建草稿、添加和编辑序列步骤、选择发件邮箱、查看潜在客户、日志和统计数据，以及启动和停止营销活动
• 潜在客户和联系人：添加、搜索、添加标签、批量编辑、查看时间线和已发送邮件，以及管理细分
• 邮箱：列出并检查已连接的邮箱、调整限制、切换预热状态、设置跟踪域名，以及检查预热状态
• 收件箱和回复：列出并阅读会话、起草和发送回复、添加标签、延后处理，以及取消计划发送
• 运行：持久、幂等且经过预检的营销活动运行（create_run、get_run、list_runs、cancel_run）
• 禁止联系名单、分析和 Webhook：管理禁止联系名单、读取仪表板分析数据，以及管理签名 Webhook

发送类工具（start_campaign、compose_email、send_reply 和自主执行的 create_run）受与凭证绑定的策略管控。调用结果可能是 executed、awaiting_approval（由人员在 30 分钟内于仪表板中批准）或 blocked。批准绝不能绕过缺失的退订选项、禁止联系名单限制或邮箱健康检查。

连接 MCP 服务

此服务会公布 OAuth 2.1 受保护资源元数据（RFC 9728），并支持动态客户端注册，因此支持 OAuth 的 MCP 客户端可以通过浏览器登录，无需粘贴密钥。也可以使用仪表板中的静态 ssk_ API 密钥，格式为 Authorization: Bearer ssk_...。

Claude Code

claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp

或者安装插件，同时添加 MCP 服务和相关技能：

/plugin marketplace add AddisonHoff/sendsets
/plugin install sendsets@sendsets

Claude（claude.ai 和 Claude Desktop）：Settings > Connectors > Add custom connector，URL 为 https://api.sendsetsapi.com/v1/mcp。

Codex

codex plugin marketplace add AddisonHoff/sendsets     # MCP server + skills as a plugin

或者仅配置 MCP 服务：

codex mcp add sendsets --url https://api.sendsetsapi.com/v1/mcp
codex mcp login sendsets

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "sendsets": { "url": "https://api.sendsetsapi.com/v1/mcp" }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "sendsets": { "type": "http", "url": "https://api.sendsetsapi.com/v1/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/AddisonHoff/sendsets

任何使用静态密钥的客户端

{
  "mcpServers": {
    "sendsets": {
      "type": "http",
      "url": "https://api.sendsetsapi.com/v1/mcp",
      "headers": { "Authorization": "Bearer ssk_..." }
    }
  }
}

安装技能

send-cold-email 是直接的操作路径：从邮箱检查到启动和回复，导入潜在客户名单并发送带后续跟进的冷邮件序列。sendsets 技能会教会 Agent 读取你的产品，提出五种使用产品本身的外联工作流，然后构建并运行你选中的工作流。sendsets-cli 技能是通过终端操作 Sendsets 的完整参考指南。

npx skills add AddisonHoff/sendsets

也可以将 skills/sendsets 复制到 ~/.claude/skills/（Claude Code）或 ~/.codex/skills/（Codex）。同一组文件也可通过 https://sendsetsapi.com/skills/sendsets/SKILL.md 获取，而 https://sendsetsapi.com/claude.md 是适用于任何编码 Agent 的一键入门链接。

CLI

brew install addisonhoff/tap/sendsets                 # macOS, Linux
sendsets login --hostname sendsetsapi.com
sendsets doctor --json

Windows：运行 scoop bucket add sendsets https://github.com/AddisonHoff/homebrew-tap，然后运行 scoop install sendsets。所有平台的归档文件和 checksums.txt 均可在 sendsets-releases 获取。CLI 以个人身份登录，且仅调用公开的 REST API；每条命令都接受 --json。

REST API

基础 URL：https://api.sendsetsapi.com/v1。错误包含稳定的 code 和 request_id，列表使用 data 和游标 pagination，会产生副作用的写入操作接受 Idempotency-Key。规范：openapi.json。参考文档：docs.sendsetsapi.com/api。

此插件连接的内容

• MCP 服务位于 https://api.sendsetsapi.com/v1/mcp，通过 HTTPS 连接，并使用你自己的 OAuth 登录或 API 密钥进行身份验证。每次工具调用都会读取或更改你的 Sendsets 工作区中的数据；发送工具会通过你已连接的邮箱发送真实邮件。
• 技能可能会指示 Agent 使用 Homebrew 或 Scoop，从 AddisonHoff/homebrew-tap 安装 sendsets CLI，也可能指示其从发布归档安装，并根据发布的 checksums.txt 进行校验。CLI 仅与 https://api.sendsetsapi.com 通信。
• 仅此而已。此插件没有钩子、没有本地服务，也没有安装时运行的脚本；其 MCP 配置绝不会从你的环境中读取凭据。

安全默认设置

Sendsets 默认采用保守设置：每个邮箱每天最多发送 50 封营销邮件，每个邮箱两次发送之间间隔 600 秒，逐步预热，遇到退信、投诉和取消订阅时自动抑制发送，并在收到回复时停止。测试发送和正式启动是两个独立的决定；除非用户要求发送，否则 Agent 不应启动营销活动。

许可证

此仓库中的技能和清单根据 Apache-2.0 许可证授权。