Cold Leads

Cold Leads MCP 服务

面向 Cold Leads（B2B 客户拓展 CRM）的模型上下文协议服务。它将托管工作区的工具开放给本地 MCP 客户端（Claude Desktop、Claude Code、Cursor、Windsurf、VS Code）：联系人、导入、同步的对话、模板、营销活动、网站信息采集、潜在客户搜索和验证。无需 API 密钥，它还可以请工作区所有者批准订阅。

npx -y @coldleads/mcp-server

无需密钥即可试用

托管演示服务在示例工作区上提供相同的工具（虚构联系人的域名为 .example）。它绝不会发送电子邮件，也不会使用额度：

claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo

然后提问：“验证这三位联系人的信息并准备拓展草稿。在我批准之前不要发送任何内容。Jana Dvořák [email protected]、[email protected]、Piotr Kowalski [email protected]”。任何支持远程（Streamable HTTP）MCP 服务的客户端都可以使用同一个 URL。基于此构建的完整 Agent：cold-leads-ai-sales-agent。

演示限制：

限制	值
会话	从开始起持续 24 hours（不会延长），仅该会话可见
联系人	10 位，包括 4 位示例联系人
模板	1 个自定义模板（示例模板除外；使用 template_id 更新）
营销活动草稿	1 个
文本长度	备注 100 个字符，模板正文 500 个字符，消息 200 个字符
请求	每个 IP 地址每分钟 120 次，每小时 20 个新会话
验证	三位演示潜在客户使用示例结果；其他地址仅执行语法、一次性域名和角色检查（不检查 MX 或邮箱）
发送	绝不发送：send_contact_message 和 launch_campaign 仍需审批，之后会返回 demo_not_sent

工具

工具	功能	费用
verify_email	验证单个地址：检查语法、一次性邮箱域名、角色账户和 MX 记录；如果 Cold Leads 能与收件人的邮件服务器建立 SMTP 连接，还会检查 SMTP 邮箱和全收件箱地址（否则，reasons 包含 smtp_unreachable，且 catch_all 为 null）。返回 valid、risky 或 invalid。通常几秒内返回结果（客户端会在 8 s 后放弃）。	1 个额度
search_leads	搜索 Cold Leads CRM 中已有的公司域名联系人，可选按职位关键词筛选：电子邮件、姓名、公司、阶段、标签、验证状态和 do_not_contact 标记。Cold Leads 没有第三方潜在客户数据库。	免费
list_contacts、import_contacts、update_contact	列出、导入每次调用最多 100 行已解析的联系人数据，并更新你自己工作区中的联系人。导入时会去重、跳过全局 DNC 条目，且不会发送电子邮件。CSV/XLSX 解析由助手完成。	免费
get_conversation、send_contact_message	查看与邮箱同步的联系人对话，或在明确批准收件人和内容后发送一封电子邮件。退订、退信和 DNC 均会被拦截。	发件人／服务提供商限制
list_templates、save_template	查看、创建和更新工作区模板；内容会经过筛查。	免费
list_campaigns、create_campaign_draft、launch_campaign	查看营销活动、准备草稿并估算受众规模；仅在人工审核并明确确认后启动。	套餐和收件人限制
get_lead_context、get_sales_next_actions、schedule_follow_up、get_agent_activity	查看某位潜在客户的所有已知信息（可联系性、历史记录、最近回复类别、下一步操作）；查看等待回复的队列和到期的后续跟进；设置联系人的下一步操作（绝不发送电子邮件）；查看 API 和 MCP 调用的审计日志。	免费
get_workspace_info、setup_website_lead_capture	查看非机密的工作区／邮箱状态，或为你的网站生成仅公开使用的表单密钥／代码片段。网站提交属于咨询线索，不代表自动同意冷启动联系。	免费
provision_account_and_get_payment_link	适用于尚无密钥的 Agent：为账户所有者（真人）创建待处理账户，并返回 Business 套餐的 Stripe 付款链接。由真人决定是否购买并付款。	—
check_provisioning_status	账户所有者付款后：仅返回一次 API 密钥（附带 claim_token）。服务端会立即开始使用该密钥。	—

响应是文本块中的精简 JSON。以下是无法检查邮箱的地址示例（example.com 是保留用于文档的域名）：

{"status":"success","email":"[email protected]","validity":"valid","catch_all":null,"score":75,"reasons":["smtp_unreachable"],"disposable":false,"role_account":false}

错误会作为工具结果返回，并带有 isError: true，例如 {"status":"error","error":"rate_limited","message":"…","http_status":429,"retry_after_seconds":60}。

要求

• 需要 Cold Leads 密钥 API 密钥（sk_…），可在 Settings → API keys 中获取。API 已包含在 Business 套餐中（每月 10,000 次验证和 API 额度；另有额外额度包可供购买）。
• Node.js 20 或更高版本（CI 测试使用 20 和 22）。
• 还没有密钥？不带密钥启动服务，让你的 Agent 调用 provision_account_and_get_payment_link — 参见Agent 入门（无需密钥）。

设置

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "coldleads": {
      "command": "npx",
      "args": ["-y", "@coldleads/mcp-server"],
      "env": { "COLDLEADS_API_KEY": "sk_your_secret_key" }
    }
  }
}

Cursor / Windsurf

~/.cursor/mcp.json（Cursor）或 ~/.codeium/windsurf/mcp_config.json（Windsurf）— 使用与上文相同的 mcpServers 配置块。

Claude Code

claude mcp add coldleads --env COLDLEADS_API_KEY=sk_your_secret_key -- npx -y @coldleads/mcp-server

VS Code

.vscode/mcp.json：

{
  "servers": {
    "coldleads": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@coldleads/mcp-server"],
      "env": { "COLDLEADS_API_KEY": "sk_your_secret_key" }
    }
  }
}

托管端点（无需安装）

支持远程服务的客户端可以使用密钥直接连接：

{
  "mcpServers": {
    "coldleads": {
      "url": "https://coldleads.app/api/mcp",
      "headers": { "Authorization": "Bearer sk_your_secret_key" }
    }
  }
}

stdio 服务会从 https://coldleads.app/api/mcp 发现工作区工具，并将调用转发至托管的 MCP 服务，因此托管工具和本地工具使用相同的账户、策略和发送保护措施。它还包含无需密钥的入门工具。ChatGPT 通过 OAuth 2.1 连接到托管端点；在 ChatGPT 中启用 Developer mode，添加端点，登录 Cold Leads 并查看请求的访问权限。其他远程 MCP 客户端可以使用上方所示的 API 密钥标头。

Docker

docker build -t coldleads-mcp-server .
docker run -i --rm -e COLDLEADS_API_KEY=sk_your_secret_key coldleads-mcp-server

配置

变量	默认值	用途
COLDLEADS_API_KEY	—	秘密 API 密钥（sk_…）。启动时可选：没有密钥，服务仍会启动、列出工具并运行 Agent 入门流程。
COLDLEADS_API_BASE	https://coldleads.app	API 基础 URL（用于针对 Cold Leads 开发服务进行本地开发）。

无需密钥的 Agent 入门流程

1. Agent 使用所有者的电子邮箱调用 provision_account_and_get_payment_link。
2. 它向用户显示返回的 checkout_url。用户在安全的 Stripe 页面上查看套餐和价格，并决定是否付款。API 不会向 Agent 提供付款方式，并且会告知 Agent 切勿打开或支付该链接。
3. Agent 每隔 15–30 秒使用 session_id 和 claim_token 轮询 check_provisioning_status。
4. 付款后，首次调用会返回一次 api_key；此服务会立即切换为使用该密钥。将其保存为 COLDLEADS_API_KEY，以供下次启动时使用。
5. 所有者会收到一封电子邮件，提示其打开 Cold Leads Web 应用，在其中管理订阅或轮换密钥。

只有携带 claim_token 的请求才能获取密钥；不带它的状态查询永远不会返回密钥。

负责任地使用

• 地址已验证并不代表已获得同意。联系每个人都需要有合法依据。
• 切勿给 do_not_contact: true 的潜在客户发送电子邮件（已选择退出、邮件退回或已加入勿联系名单）。
• 限制：每个密钥每分钟 120 个请求；每次验证消耗 1 个额度。

开发

npm ci
npm run build
npm test                      # schema, server and stdio child-process tests
COLDLEADS_API_KEY_FILE=path/to/key COLDLEADS_API_BASE=http://localhost:3000 node scripts/smoke.mjs   # live checks

许可证

MIT © 2026 Anton Tkachenko