warmysender

面向 AI Agent 的 WarmySender

WarmySender 是一个触达平台，提供五个渠道——冷邮件、邮件预热、LinkedIn、Instagram 和 WhatsApp——以及实时邮件验证和超过 2 亿条 B2B 线索数据库。本技能将教会 Agent（Claude、ChatGPT、Cursor、Codex、OpenClaw 和 Hermes Agent，或任何支持 MCP 的 Agent）如何通过托管的 WarmySender MCP 服务来使用它。

你的 Agent 可以用自然语言执行完整的触达工作——创建、启动和管理冷邮件、LinkedIn、Instagram 和 WhatsApp 活动，验证邮件、搜索并保存线索，以及调整预热设置——而无论由谁来操作，WarmySender 的调度器都会确保每个账户始终处于安全限制范围内。

---

1. 先连接

WarmySender 是一个托管的 MCP 服务（可流式传输的 HTTP），地址为：

https://warmysender.com/mcp

默认使用登录。 客户端会自行注册，用户在浏览器中登录 WarmySender，无需粘贴密钥。仅当客户端无法登录或用户更偏好使用密钥时，才使用 API 密钥配置方式。

如果你的 Agent 完全没有 MCP 设置，用户可以将以下段落粘贴到聊天中：

连接到 WarmySender：它是一个位于 https://warmysender.com/mcp 的 MCP 服务，使用 OAuth 登录（无需 API 密钥）。将其添加为可流式传输的 HTTP MCP 服务，打开它返回的登录链接并批准访问，然后从 https://github.com/fortuneflick/warmysender-claude-plugin 安装 WarmySender 技能（npx skills add fortuneflick/warmysender-claude-plugin）。切勿自行发送消息——WarmySender 的调度器会控制每封邮件以及 LinkedIn、Instagram 和 WhatsApp 操作的发送节奏，确保它们处于安全限制范围内。

各客户端的连接命令

Claude

登录（默认）：

https://warmysender.com/mcp

在 Claude 中打开 Customize → Connectors，选择 +，然后选择 Add custom connector，粘贴此地址并点击 Add。随后 Claude 会打开 WarmySender 登录页面，批准登录后即可完成连接。

API 密钥备用方式——claude_desktop_config.json：

{
  "mcpServers": {
    "warmysender": {
      "command": "npx",
      "args": [
        "-y",
        "@warmysender/mcp",
        "--api-key=ws_YOUR_API_KEY_HERE"
      ]
    }
  }
}

粘贴到你的 claude_desktop_config.json 中，然后重启 Claude Desktop。

ChatGPT

登录（默认）：

codex mcp add warmysender --url https://warmysender.com/mcp
codex mcp login warmysender

ChatGPT Plus 及更高级别的所有套餐均包含 Codex。在终端中运行这两行命令；第二行会打开浏览器，以便登录 WarmySender。

API 密钥备用方式：

export WARMYSENDER_API_KEY=ws_YOUR_API_KEY_HERE
codex mcp add warmysender --url https://warmysender.com/mcp --bearer-token-env-var WARMYSENDER_API_KEY

ChatGPT Plus 及更高级别的所有套餐均包含 Codex。运行这两行命令，并将 export 添加到 shell 配置文件中，以便保留设置。

Claude Code

登录（默认）：

claude mcp add --transport http warmysender https://warmysender.com/mcp

在终端中运行一次此命令，然后在 Claude Code 中输入 /mcp（或运行 claude mcp login warmysender），并在浏览器中登录 WarmySender。

API 密钥备用方式：

claude mcp add --transport http warmysender https://warmysender.com/mcp --header "Authorization: Bearer ws_YOUR_API_KEY_HERE"

在终端中运行一次此命令。

Cursor

登录（默认）——.cursor/mcp.json：

{
  "mcpServers": {
    "warmysender": {
      "url": "https://warmysender.com/mcp"
    }
  }
}

使用 Add to Cursor 按钮，或将此内容粘贴到项目根目录下的 .cursor/mcp.json 中，并在 Cursor 提示时登录。

API 密钥备用方式——.cursor/mcp.json：

{
  "mcpServers": {
    "warmysender": {
      "url": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

使用 Add to Cursor 按钮，或将此内容粘贴到项目根目录下的 .cursor/mcp.json 中。

Codex

登录（默认）：

codex mcp add warmysender --url https://warmysender.com/mcp
codex mcp login warmysender

在终端中运行这两行命令；第二行会打开浏览器，以便登录 WarmySender。

API 密钥备用方式：

export WARMYSENDER_API_KEY=ws_YOUR_API_KEY_HERE
codex mcp add warmysender --url https://warmysender.com/mcp --bearer-token-env-var WARMYSENDER_API_KEY

运行这两行命令，并将 export 添加到 shell 配置文件中，以便保留设置。

OpenClaw

登录（默认）：

openclaw mcp add warmysender --url https://warmysender.com/mcp --transport streamable-http --auth oauth
openclaw mcp login warmysender

运行这两行命令；第二行会在浏览器中打开 WarmySender 登录页面。登录启用时，OpenClaw 会忽略静态标头，因此不会存储密钥。

API 密钥备用方式：

openclaw mcp set warmysender '{"url":"https://warmysender.com/mcp","headers":{"Authorization":"Bearer ws_YOUR_API_KEY_HERE"}}'

运行一次此命令以注册 WarmySender。随后 OpenClaw 即可调用 WarmySender 的任意 78 个工具。

Hermes Agent

登录（默认）——~/.hermes/config.yaml：

mcp_servers:
  warmysender:
    url: "https://warmysender.com/mcp"
    auth: oauth

将此内容添加到 ~/.hermes/config.yaml，然后在聊天中运行 /reload-mcp，并按提示登录。

API 密钥备用方式——~/.hermes/config.yaml：

mcp_servers:
  warmysender:
    url: "https://warmysender.com/mcp"
    headers:
      Authorization: "Bearer ws_YOUR_API_KEY_HERE"

将此内容添加到 ~/.hermes/config.yaml，然后在聊天中运行 /reload-mcp。

Muse Code

此客户端使用 API 密钥连接 — ~/.config/muse/settings.json：

{
  "schema_version": 1,
  "mcp_servers": {
    "warmysender": {
      "transport": "streamable_http",
      "url": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

将此内容保存为 ~/.config/muse/settings.json（如果文件夹尚不存在，请创建），然后重新启动 Muse Code。保留 schema_version 行 — 缺少该行时，Muse Code 会拒绝此文件。如果已有 settings 文件，只需在现有的 mcp_servers 中添加 warmysender 区块。

Grok Bot

此客户端使用 API 密钥连接：

{
  "name": "warmysender",
  "url": "https://warmysender.com/mcp",
  "headers": {
    "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
  }
}

打开 grok.com/connectors → New Connector → Custom，粘贴服务地址，并将密钥用作 bearer token。在聊天中输入 @，即可关联 WarmySender。

Windsurf

登录（默认方式）— ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "warmysender": {
      "serverUrl": "https://warmysender.com/mcp"
    }
  }
}

粘贴到 ~/.codeium/windsurf/mcp_config.json 中，并在 Windsurf 提示时登录。

API 密钥备用方式 — ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "warmysender": {
      "serverUrl": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

粘贴到 ~/.codeium/windsurf/mcp_config.json 中。

Zed

此客户端使用 API 密钥连接 — settings.json：

{
  "context_servers": {
    "warmysender": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@warmysender/mcp",
          "--api-key=ws_YOUR_API_KEY_HERE"
        ]
      }
    }
  }
}

在 Zed 的 settings.json 中，将其添加到 context_servers 下。

API 密钥备用方式

在 WarmySender 应用的 Settings → API Keys 下创建密钥（密钥以 ws_ 开头）。仅授予密钥完成任务所需的作用域 — 报告任务使用只读密钥即可。切勿将密钥粘贴到聊天消息、日志或提交的文件中；应按上述说明将其放入客户端配置或环境变量中。你可以随时在同一 Settings 页面轮换密钥。

---

2. Agent 必须遵守的规则（请先阅读）

1. 绝不要自行发送消息。 没有“发送”工具。create_* 会创建草稿；start_*、resume_* 和 enroll_* 只会将工作交给 WarmySender 的调度器，由调度器在每个账户安全的每日、每周和每小时限制以及新账户的渐进式提量范围内，控制每一项电子邮件、LinkedIn、Instagram 和 WhatsApp 操作的节奏。
2. 绝不要声称可以提高限制。 没有任何工具可以提高上限、跳过渐进式提量或绕过检查。如果活动进展缓慢，请说明发送节奏（list_skipped_actions、get_linkedin_campaign_throttle）— 不要“加大力度重试”。
3. 账户的连接或断开操作必须在应用中进行。 邮箱、LinkedIn 账号、Instagram 账户和 WhatsApp 号码由用户在 warmysender.com 上连接。如果没有连接任何账户，请如实说明并停止。
4. 首先调用 get_workspace_info。 它会告知你所在的工作区、持有的作用域以及套餐允许的操作。不要猜测。
5. 先读后写。 进行任何写入操作前，优先使用 list_* / get_* 工具确认状态（现有活动、模板、邮箱和额度）。
6. 调用 start_*、resume_*、enroll_*、pause_*、unenroll_*、delete_*、close_*、cancel_* 和 remove_* 前，必须先征得用户确认。 下方目录中标记为破坏性操作的工具带有 destructiveHint — 向用户说明将发生的变更，并等待用户确认。切勿自行对启动工具传入 force: true；应报告列出的问题，只有用户明确表示“仍要启动”时才传入该参数。
7. 每个冷邮件活动都必须设置发送时段和退订说明。 在 create_campaign 上设置 sending_window_start / sending_window_end / schedule_days / timezone，并确保已配置工作区页脚（update_workspace_settings：邮寄地址、退订样式 link 或 reply、退订文案）。页脚会自动附加 — 不要手动再写一条退订说明。
8. 支出会在发生前明确显示。 在 submit_verification_batch 前检查 get_verification_allowance；search_leads 免费，save_leads / export_leads 会使用月度额度或潜在客户点数。使用前说明将消耗多少额度。
9. 报告事实，不要猜测。 引用工具返回的结果（数量、状态、原因）。如果工具返回错误，请原样向用户展示错误消息并停止；不要循环重试。

---

3. 工具目录（78 个工具）

所有 78 个工具都限定在工作区范围内：工具只能查看已登录用户（或密钥）所属的工作区。“只读”工具不会更改任何内容；“修改”工具会写入草稿、设置或调度器任务；“破坏性”工具会停止、移除或取消某项内容，因此应先确认。

冷邮件与潜在客户（19 个工具）

通过自然语言创建、启动、暂停和恢复冷邮件活动；添加、更新和批量导入潜在客户；并管理抑制名单。

工具	类型	功能
create_campaign	修改	创建一项处于草稿状态的新邮件活动。
update_campaign	修改	部分更新一项活动。
start_campaign	修改	启动一项邮件活动。
pause_campaign	修改（破坏性操作 — 请先确认）	暂停正在运行的邮件活动。
resume_campaign	修改	恢复已暂停的邮件活动。
enroll_prospects	修改	将潜在客户添加到邮件活动中。
unenroll_prospects	修改（破坏性操作 — 请先确认）	停止针对特定潜在客户的活动（软取消；保留审计记录）。
create_prospect	修改	在工作区中创建潜在客户（或复用现有客户），并可选择将其添加到名单中。
update_prospect	修改	部分更新潜在客户的字段。
bulk_create_prospects	修改	一次调用最多创建 500 个潜在客户。
add_to_suppression_list	修改	将邮箱或域名加入抑制名单，防止工作区中的任何活动今后向其发送邮件。
list_campaigns	只读	返回工作区中的邮件活动。
get_campaign	只读	返回一项邮件活动的完整详情，包括步骤（邮件序列）、顶层统计数据，以及该活动实际会添加到页脚中的退订信息。
list_prospects	只读	使用游标分页返回工作区中的潜在客户。
get_prospect	只读	返回一位潜在客户的完整详情，包括自定义字段、所属名单和参与活动的历史摘要。
list_suppressions	只读	返回工作区的抑制名单（不会联系的邮箱和域名）。
list_skipped_actions	只读	说明某项活动近期发送量很少或没有发送的原因：按原因分组列出过去 N 小时内未执行的操作，为每项操作提供通俗易懂的说明，并标明这是会自动恢复的正常节奏，还是需要关注的问题。
list_email_templates	只读	返回工作区已保存的邮件模板（名称、类别、主题、预览文本）。
get_email_template	只读	完整返回一份已保存的邮件模板，包括主题、预览文本和正文。

跟踪域名（4 个工具）

使用自己的品牌域名跟踪邮件打开和点击。添加跟踪域名、检查其配置是否正确、查看已有域名，并移除不再需要的域名。

工具	类型	功能
add_tracking_domain	修改	添加自定义邮件打开／点击跟踪域名。
verify_tracking_domain	修改	检查跟踪域名的 CNAME 记录是否设置正确，并将其标记为已验证或出错。
list_tracking_domains	只读	返回工作区的自定义邮件打开／点击跟踪域名及其验证状态（待处理、已验证或出错）、需要设置的 CNAME 目标，以及上次检查和验证的时间戳。
remove_tracking_domain	修改（破坏性操作 — 请先确认）	按 ID 从工作区删除自定义跟踪域名。

LinkedIn — 营销活动、帖子与招聘（19 个工具，受安全限制）

端到端管理 LinkedIn：开展连接和消息营销活动、发布和管理帖子，以及创建、发布或关闭招聘职位并查看申请者。每项操作都会遵守账号安全的每日和每周限额，控制操作频率。

工具	类型	功能
create_linkedin_campaign	修改型	创建新的 LinkedIn 外联营销活动草稿（由一系列步骤组成，例如 send_invite、wait_accept、send_message、wait_reply 和条件分支）。
start_linkedin_campaign	修改型	启动 LinkedIn 营销活动草稿（或恢复已暂停的活动），使其开始运行。
pause_linkedin_campaign	修改型（有破坏性 — 请先确认）	暂停正在运行的 LinkedIn 营销活动。
resume_linkedin_campaign	修改型	恢复已暂停的 LinkedIn 营销活动。
enroll_in_linkedin_campaign	修改型	将潜在客户加入 LinkedIn 营销活动队列。
create_linkedin_post	修改型	创建 LinkedIn 帖子草稿，或将其安排在未来时间发布（系统会自动以安全频率发布）。
publish_linkedin_post	修改型	立即发布之前起草或安排的 LinkedIn 帖子，并遵守安全频率（遵守每日发帖限额）。
delete_linkedin_post	修改型（有破坏性 — 请先确认）	删除草稿、已安排或发布失败的 LinkedIn 帖子。
create_linkedin_job	修改型	创建 LinkedIn Recruiter 职位发布草稿（需要 Recruiter 席位）。
publish_linkedin_job	修改型	发布一则 LinkedIn Recruiter 职位信息。
close_linkedin_job	修改型（有破坏性 — 请先确认）	关闭一则 LinkedIn Recruiter 职位信息，使其停止接受申请。
list_linkedin_accounts	只读	返回已连接的 LinkedIn 账号及其状态、策略，以及当前每日／每周用量与安全限额的对比。
get_linkedin_account_health	只读	返回详细的 LinkedIn 账号健康指标：接受率、回复率、限制、连续错误次数，以及安全限额余量。
list_linkedin_campaigns	只读	返回 LinkedIn 营销活动及其状态和顶层计数器。
get_linkedin_campaign_stats	只读	返回完整的营销活动健康指标：已发送／已接受的邀请、已发送／已回复的消息，以及使用 A/B 测试时各变体的表现。
get_linkedin_campaign_throttle	只读	说明 LinkedIn 营销活动当前为何发送或未发送：哪些每日或每周限额正在限制活动、限额何时刷新、同一 LinkedIn 账号关联了多少个营销活动，以及该活动分得的账号限额和今日已使用量的对比（按操作类型区分）。
list_linkedin_posts	只读	返回工作区的 LinkedIn 帖子（草稿、已安排、已发布、失败），包括状态、内容、安排时间、解析后的 URL 和互动计数器。
list_linkedin_jobs	只读	列出已连接账号的 LinkedIn Recruiter 职位信息（实时查询，且受频率限制以保护账号）。
list_linkedin_job_applicants	只读	列出已连接账号中某则 LinkedIn Recruiter 职位信息的申请者（实时查询，且受频率限制以保护账号）。

WhatsApp 消息（9 个工具，安全门控）

创建并启动 WhatsApp 营销活动、招募潜在客户，并检查号码健康状况和结果。新号码会逐步提高发送量，并遵守安全的每日、首条消息和每小时额度，消息之间还会自然暂停。

工具	类型	功能
create_whatsapp_campaign	修改型	创建处于草稿状态的 WhatsApp 外联营销活动。
start_whatsapp_campaign	修改型	启动 WhatsApp 营销活动。
pause_whatsapp_campaign	修改型（破坏性操作 — 请先确认）	暂停正在运行的 WhatsApp 营销活动。
resume_whatsapp_campaign	修改型	恢复已暂停的 WhatsApp 营销活动。
enroll_in_whatsapp_campaign	修改型	将潜在客户加入 WhatsApp 营销活动队列。
list_whatsapp_accounts	只读	返回已连接的 WhatsApp 号码及其状态、逐步提升阶段，以及当前每日、新聊天和每小时用量相对于安全限制的情况。
get_whatsapp_account_health	只读	返回 WhatsApp 号码的详细健康状况：30 天回复率、限制、连续错误次数、节流状态，以及相对于安全限制剩余的每日、新聊天和每小时额度。
list_whatsapp_campaigns	只读	返回 WhatsApp 营销活动及其状态和主要计数器（已招募人数、已发送消息数、回复数）。
get_whatsapp_campaign_stats	只读	返回完整的营销活动指标：发起的新聊天数、已发送消息数、收到的回复数、回复率，以及使用 A/B 测试时的变体表现。

Instagram 私信（9 个工具，安全门控）

创建并启动 Instagram 私信营销活动、招募潜在客户，并检查账户健康状况和结果。新账户会逐步提高操作量，并遵守安全的每日和每小时操作额度。

工具	类型	功能
create_instagram_campaign	修改型	创建处于草稿状态的 Instagram 私信／外联营销活动。
start_instagram_campaign	修改型	启动 Instagram 营销活动。
pause_instagram_campaign	修改型（破坏性操作 — 请先确认）	暂停正在运行的 Instagram 营销活动。
resume_instagram_campaign	修改型	恢复已暂停的 Instagram 营销活动。
enroll_in_instagram_campaign	修改型	将潜在客户加入 Instagram 营销活动队列。
list_instagram_accounts	只读	返回已连接的 Instagram 账户及其状态、逐步提升阶段，以及当前每日和每小时用量相对于综合安全限制的情况。
get_instagram_account_health	只读	返回 Instagram 账户的详细健康状况：30 天回复率、限制、连续错误次数，以及相对于综合安全限制剩余的每日和每小时操作额度。
list_instagram_campaigns	只读	返回 Instagram 营销活动及其状态和主要计数器（已招募人数、关注数、已发送私信数、回复数）。
get_instagram_campaign_stats	只读	返回完整的营销活动指标：已发送的关注数、已发送私信数、收到的回复数、回复率，以及使用 A/B 测试时的变体表现。

预热与邮箱（5 个工具）

调整预热设置、一次性批量修改多个邮箱，并在扩大邮件发送量之前检查邮箱健康状况和预热提升状态。

工具	类型	功能
update_warmup_settings	修改型	修改单个邮箱的预热配置：启用／禁用、每日目标量、策略类型。
bulk_update_warmup	修改型	一次性将相同的预热设置应用于多个邮箱。
list_mailboxes	只读	返回所有已连接的电子邮件邮箱及其状态、预热状态和主要健康状况。
get_mailbox_health	只读	返回单个邮箱的详细健康状况和送达能力状态，包括近期问题。
get_warmup_stats	只读	返回电子邮件预热统计数据。

邮箱验证（7 个工具）

验证单个地址或提交整份列表；在使用额度前查看剩余额度；跟踪结果并查看进度；停止任务并退回未使用的额度；将可用结果整理为可直接使用的列表——结果会列出已确认的邮箱，以及位于接受所有地址的邮件服务器上的邮箱，让你的 Agent 知道实际可用的地址。整个过程遵循与应用内验证器相同的安全速率和额度限制，因此 Agent 无法突发式调用。

工具	类型	功能
verify_email	修改型	验证单个邮箱地址，并返回其状态是有效、无效、有风险还是未知。
submit_verification_batch	修改型	提交最多 5,000 个邮箱地址进行验证，并返回一个任务 ID，可用于通过 get_verification_result 查询结果。
get_verification_result	只读	返回验证任务的进度和每个地址的验证结果，也可按某一种结果筛选。
list_verification_batches	只读	按时间倒序列出此工作区的邮箱验证任务及其状态和结果数量。
get_verification_allowance	只读	返回当前可验证的邮箱地址数量：额度来源（套餐额度、购买的点数或每日一次的免费检查）、本月和今日剩余的套餐额度、点数余额、今日剩余的免费检查次数，以及可接受的最大单次批量数量。
cancel_verification_batch	修改型（有破坏性——请先确认）	停止仍在进行中的验证任务，并退回未使用的点数。
create_list_from_verification	修改型	根据已完成的验证任务创建可重复使用的潜在客户列表。

潜在客户数据库（3 个工具）

按职位、行业和地点搜索 2 亿多个 B2B 潜在客户，然后将所需对象保存到潜在客户列表，或导出其完整联系信息。搜索免费；每新增一位潜在客户会使用你的月度额度或已购买的潜在客户点数。

工具	类型	功能
search_leads	只读	按关键词、地点（包括邮政编码／ZIP 前缀和街道）、行业、职位名称、资历级别、部门和数据可用性筛选条件搜索 2 亿多个 B2B 潜在客户。
save_leads	修改型	将数据库中的潜在客户保存到潜在客户列表中（如果提供了 new_list_name，则创建新列表）。
export_leads	修改型	将数据库中的潜在客户导出为包含完整、未屏蔽联系信息（邮箱、电话等）的行。

工作区与任务（3 个工具）

确认 API 密钥可访问的内容，设置冷邮件页脚中使用的邮政地址、退订方式和退订文案，并跟踪排队任务或批量操作的状态。

工具	类型	功能
get_workspace_info	只读	返回此 API 密钥所属工作区的基本信息、授予此密钥的权限范围、账户的账单状态以及 MCP 服务版本。
update_workspace_settings	修改型	设置冷邮件页脚中显示的邮政地址，选择收件人的退订方式，并自行撰写退订说明。
get_job_status	只读	查看长时间运行的请求进度（例如批量预热更新或邮箱连接测试）。

---

4. 工作流和提示词示例

从名单开展冷邮件营销活动

“创建一个名为‘Q4 agencies’的 3 步冷邮件营销活动，使用‘Agencies EU’名单，周一至周五 9–17 点（Europe/Berlin 时区）发送，每个邮箱每天 40 封，有回复时停止。第 1 步使用我的‘Intro v2’模板。开始前先给我看草稿。”

1. get_workspace_info → list_mailboxes（选择预热完成且状态良好的邮箱）→ list_prospects / 名单 ID → list_email_templates → get_email_template。
2. 使用步骤、timezone、sending_window_start/end、schedule_days、max_sends_per_mailbox_per_day、stop_on_reply、mailbox_ids 调用 create_campaign。
3. 如果用户尚未设置地址 / 退订方式，请通过 update_workspace_settings 确认页脚内容。
4. enroll_prospects（名单 ID）→ 显示摘要 → 询问用户 → start_campaign。
5. 后续：使用 get_campaign 查看统计数据；用户询问发送量为何这么少时，使用 list_skipped_actions。

调整预热设置

“哪些邮箱仍在逐步提升发送量？把所有超过第 14 天的 Google 邮箱都设为每天发送 40 封预热邮件，回复率设为 30%。”

list_mailboxes → get_warmup_stats / get_mailbox_health → bulk_update_warmup（返回任务 ID）→ get_job_status。预热会自行持续运行；你只需调整设置。

LinkedIn 营销活动

“创建一个 LinkedIn 营销活动：发送附有简短留言的邀请，等待对方接受，然后发送一条 2 行消息。将‘SaaS founders’名单添加到我的主账号，并启动活动。”

list_linkedin_accounts → get_linkedin_account_health → create_linkedin_campaign（步骤示例：send_invite → wait_accept → send_message）→ enroll_in_linkedin_campaign → 询问用户 → start_linkedin_campaign。如果进度看起来很慢，get_linkedin_campaign_throttle 会说明当前受限的额度及恢复时间。

Instagram 私信营销活动

“从 @ourbrand 向‘Fitness creators’名单发起 Instagram 私信营销活动，发送两条消息，间隔 24 小时。”

list_instagram_accounts → get_instagram_account_health → create_instagram_campaign → enroll_in_instagram_campaign → 询问用户 → start_instagram_campaign。新账号会逐步提升发送量；请说明当前所处的提升阶段，而不要承诺具体发送量。

WhatsApp 营销活动

“使用 +44 号码，为‘Webinar sign-ups’名单创建 WhatsApp 营销活动：今天发送一条消息，若未收到回复，则 3 天后跟进。”

list_whatsapp_accounts → get_whatsapp_account_health → create_whatsapp_campaign → enroll_in_whatsapp_campaign → 询问用户 → start_whatsapp_campaign。向新联系人发送的首条消息有单独的每日额度；如果用户预期发送量更高，请向其说明。

验证名单

“验证‘Trade show 2026’名单，并为我创建一份只包含可投递地址的干净名单。”

get_verification_allowance → 告知用户费用 → submit_verification_batch（list_id）→ 持续调用 get_verification_result，直到完成 → create_list_from_verification。如果用户改变主意，使用 cancel_verification_batch；未使用的额度会退还。

搜索 2 亿多个潜在客户并保存

“查找德克萨斯州软件公司的营销总监，先给我看 25 个，再把最合适的 100 个保存到名为‘TX marketing’的新名单中。”

search_leads（免费，结果经过掩码处理）→ 展示结果 → 确认额度 / 积分用量 → 使用 new_list_name 调用 save_leads，或调用 export_leads 导出完整数据行。然后按上述方式将名单添加到营销活动中。

---

5. 故障排查

• 登录循环／Agent 一直要求登录 — 按照 https://warmysender.com/documentation/connecting-an-ai-agent-that-asks-you-to-sign-in 操作（在 Agent 打开的同一浏览器配置文件中完成登录；如果令牌已撤销，请移除并重新添加服务）。
• "insufficient scope" — 密钥缺少工具所需的权限范围。请在 Settings → API Keys 下创建一个权限范围正确的新密钥，然后重新连接；get_workspace_info 会列出密钥所拥有的权限范围。
• "plan upgrade required"／某项功能不可用 — 工作区套餐不包含该渠道或 Agent 吞吐量。请告知用户受限的功能，并引导其访问 https://warmysender.com/pricing；不要重试。
• 已启动营销活动，但没有发送任何内容 — 通常是发送节奏控制所致。读取 list_skipped_actions（邮件）或 get_linkedin_campaign_throttle（LinkedIn），并说明原因；不要通过暂停／恢复来“启动”它。
• 未连接邮箱／账户 — 连接账户需要在应用中完成，而不是由 Agent 操作。请引导用户访问 warmysender.com。

---

6. 链接

• 服务与设置文档：https://warmysender.com/mcp
• Agent 可执行的操作：https://warmysender.com/ai-agents
• 连接你的 Agent：https://warmysender.com/documentation/connect-your-ai-agent
• 定价：https://warmysender.com/pricing
• 技能与插件源代码：https://github.com/fortuneflick/warmysender-claude-plugin