PumpGTM MCP server

工具参考

根据 2026-10-12 的实时 tools/list 生成：共 34 个工具。“只读”工具不会写入数据。未启用相应功能的工作区调用受功能限制的工具组时，会返回结构化错误。每个工具还接受一个可选的 workspaceId：Team 所有者可用它操作自己的某个工作区；若操作自己的工作区，则省略此参数。

从这里开始

get_workspace（只读）

从这里查看账户状态。只读的 schemaVersion 2 摘要包含：公司、账单访问权限、每个已保存的 LinkedIn/X/电子邮件/Instagram 发件人及其独立的连接状态、健康状况和执行证据、所有 Play 类型和序列状态、审核覆盖范围、带周期标签的结果、发现额度和已排除的公司。每个部分都会返回状态、数据和问题；未知不代表未连接或为零。列表为有限预览，并附带总数。缺少可选渠道不会阻止其他渠道运行。请按范围处理需关注事项，并查看返回的 Accounts/Billing/Company 链接。view=activity 会读取工作区审计账本；view=x_posts 会从服务提供商读取近期 X 帖子，并可能刷新该账户的授权。

energy

读取此工作区的 Energy（剩余量、各项操作的费用、本月用量和续期信息）；估算计划中的工作会消耗多少 Energy；并在用户要求时获取购买套餐或开启、关闭自动充值的付款链接。购买需要客户打开链接并完成付款。开启自动充值会授权使用已保存的银行卡进行后续扣款，并且必须在说明金额和触发阈值后取得客户的明确同意。

查找并审核人员

find_people

根据定向条件创建或修改 Play 并运行。定向条件可以包含招聘信号（currentCompanyHiringRolesAny）：该人员所在公司当前必须有其中某个职位的在招岗位，且发布时间在 currentCompanyHiringPostedWithinDays 内。也可以包含融资信号（currentCompanyRaisedWithinDays，可选搭配 currentCompanyRoundTypesAny 和 currentCompanyMinRaisedUsd）：该人员所在公司必须近期完成一轮融资；此类 Play 每天会重新运行一次，以便持续发现新获得融资的公司供审核。若 confirmed=true，则只保存 Play 并返回定向条件摘要，供客户确认。公司名称会自动解析，且不会成为阻碍：当多个公司名称相同时，排除条件会涵盖所有这些公司，必需公司条件则会包含所有强匹配项；传入 currentCompanyDomainsAny 中的网站域名或 currentCompanyLinkedInUrlsAny 中的 LinkedIn 公司 URL，可准确指定公司。结果中的 companyResolution 会报告每家公司的解析结果（matched、matched_several、unmatched）及选定的公司；如有需要，可用一句话提及。confirmed=true 时，Play 会运行发现流程并按检索顺序返回候选人。仅传入 playId 可重新运行现有的 ready Play。可选的 sequenceId 会设置 Play 的默认序列。不会创建潜在客户，也不会联系任何人。

review_people

不传入决策时：读取一个审核批次及其候选人和已保存的选择。传入决策时：记录客户明确选择的 good_fit 和 not_a_fit；顶层的 sequenceId 会应用于每个 good_fit，finish=true 会完成审核并将 good_fit 候选人加入序列。若要全部添加，请将每位候选人标记为 good_fit 并设置 finish=true。此调用不会发送任何内容。开放世界：加入实时序列的人员之后会按序列的节奏步骤接受联系。

search_known_people（只读）

在获准共享的职业证据中，搜索公司、职业角色或明确提及的加速器届次。最多返回 20 个匹配身份；覆盖范围不完整，包含标注的历史职位和解读。这不是实时服务商搜索，不会公开其他客户的名单或消息，也不授权联系任何人。推荐人选前请检查来源日期。

get_lead_profile（只读）

读取此工作区所拥有潜在客户的带来源日期的公开身份信息、可用任职经历、公开活动和关系观察。公开个人资料链接和 AI 解读需要审核。这不会获取服务商数据、更改身份、将任何人加入序列或联系任何人。

序列

list_sequences（只读）

列出序列及其步骤、审批状态、状态和已加入潜在客户的准确数量。传入 sequenceId 可读取某个序列及其准确修订版本，然后再进行编辑。

save_sequence_draft

不提供 sequenceId：创建一个完整的新序列（名称和有序步骤）；客户的请求即为批准，因此此调用返回时序列已获批准并上线。提供 sequenceId 和 expectedRevision：替换序列的完整步骤列表；新版本获批准，且序列恢复到之前的状态（活跃状态保持活跃，暂停状态保持暂停，草稿则上线）。步骤可以是 connect、message、engage（LinkedIn）、email（主题加正文；仅在工作区启用了电子邮件时可用），或 x_dm（向 X 帖子点赞者发送 X 私信；X 序列只能包含 x_dm 步骤，且仅适用于启用了 X 渠道的工作区）。只要包含任何 LinkedIn 步骤，第 0 步就必须是 connect；仅包含电子邮件的序列无需 connect。delayDays 从上一步开始计算（connect 后的步骤会等待对方接受邀请）；如果对方在任何渠道回复，后续步骤都会跳过。{{firstName}} {{fullName}} {{company}} {{title}} 在两个渠道中都会被替换。{{ai_intro}}（用于 message 和 email 步骤）是 Eve 根据每个人的职位和近期 LinkedIn 帖子，在其到达该步骤时撰写的一句开场白，并会保存供后续步骤使用；每人耗费 0.1 Energy。如果无法撰写，则显示纯文本 |fallback；若未提供 fallback，则显示 'Hope your week is going well.'，因此请将其单独放在一行。message 步骤还可以包含客户之后提供的、针对每个人的值（例如 {{video_url}}）；使用 tool { kind: "customer_input", tokens: [...] } 声明该值，在 set_lead_input 存储该值之前，每个人都会停留在此步骤。混合流程示例：connect、message +1d、email +2d、email +2d、email +3d。此调用不会发送任何内容；之后添加的人会进入按节奏执行的队列。向客户提供结果中的 reviewUrl，以便其查看或暂停序列。开放世界：保存的序列会上线，因此其中的步骤会联系已加入序列的人员；这些人员是第三方。

set_sequence_status

对于 LinkedIn 序列（sequenceId）：paused 会为所有已加入序列的潜在客户暂停该序列；active 会恢复已暂停的序列；draft 会在仪表板中重新开放序列以供编辑。status=approved（必须提供 expectedRevision）仅适用于仍处于草稿状态的序列，例如在仪表板中创建的序列：此状态会记录客户对该特定版本的批准，并在同一次调用中使序列上线。通过 save_sequence_draft 创建或编辑的序列，以及通过 MCP 将人员添加到的草稿序列，已经上线，无需在此处批准。对于电子邮件营销活动（emailCampaignId）：active 会在其计划和限制范围内启动发送；paused 会停止发送；draft 会重新开放活动；approved 不适用。开放世界：设为 active 或 approved 后，PumpGTM 的按节奏执行引擎会向已加入序列的人员发送连接请求、消息和电子邮件；这些人员是第三方。

sequence_email_settings

读取某个序列的邮件发送收件箱、日程安排和每日限额。提供要替换的设置，以使用此工作区的冷外联邮箱。不会更改序列状态，也不会立即发送；处于活跃状态的序列可在下一个按节奏执行的时点发送。已暂停或断开连接的收件箱仍会保持暂停或断开连接状态。不消耗 Energy。

Leads

list_leads (read only)

此工作区的潜在客户及其 LinkedIn 和序列进度。stage 为累计阶段（已达到此里程碑或更进一步）；stageExact 仅表示当前所处位置。即使页面结果有限，计数仍为精确值。传入 leadId 可完整读取单个潜在客户。

add_leads

将潜在客户加入一个已批准的序列：contacts 接受 1–500 个提供的人员，其身份信息可包含 LinkedIn、邮箱和／或 X，并需提供 expectedRevision。它支持仅有 X 或仅有邮箱的联系人，会保留提供的字段，不执行付费信息补全，会跨所有渠道跳过已有身份，并保持已暂停的序列处于暂停状态。其他方法接受手动输入的 LinkedIn 个人资料、CSV 内容或已保存的 Sales Navigator 列表 URL。手动输入和 CSV 会立即完成，并返回新增、重复和无效计数以及稳定的 addedLeadIds。Sales Navigator 会在后台运行并自动加入序列；使用 batchId 调用 method=import_status 进行检查。本次调用不会发送任何内容。

输入为以下某一种形式：

• method: "contacts"，包含 requestId（必填）、sequenceId（必填）、expectedRevision（必填）、leads（必填）
• method: "manual"，包含 requestId（必填）、sequenceId（必填）、leads（必填）
• method: "csv"，包含 requestId（必填）、sequenceId（必填）、csvContent（必填）、customColumns
• method: "sales_navigator"，包含 requestId（必填）、sequenceId（必填）、accountId、listUrl（必填）
• method: "import_status"，包含 batchId（必填）

remove_leads

仅当客户明确要求撤销添加操作或停止处理潜在客户时使用。目标可以是潜在客户 ID、add_leads 返回的一个 batchId，或 target=companies 加雇主名称：这些公司会加入工作区的禁止联系名单（见 get_workspace），每个 Play 都会停止在这些公司寻找人员，不会再添加这些雇主的任何潜在客户，并会移除已在队列中的所有相关人员。尚未联系的潜在客户会从队列中移除；已联系的潜在客户会保留历史记录，且不会再收到自动步骤。已发送的邀请和消息无法撤回。

输入为以下某一种形式：

• target: "leads"，包含 leadIds（必填）
• target: "import"，包含 batchId（必填）
• target: "companies"，包含 companies（必填）

set_lead_input

为一位客户存储其提供的值，例如他们录制的视频链接，以便声明使用 tool customer_input 的消息步骤可以发送消息。使用 leadId 或其 LinkedIn 个人资料 URL 标识该联系人。values 将序列的令牌名称（例如 video_url）映射到客户提供的文本；键来自序列，客户不会输入该键。此调用不会发送任何内容：如果该联系人正处于该步骤，或之后到达该步骤，节奏引擎会在下一次运行时发送消息。若某人已经回复、已完成，或已收到该消息，则会拒绝为其设置值，且不作任何更改。结果会包含该序列中仍在等待的联系人数量。开放世界：存储的值会释放一条暂缓的消息，发送给该联系人这一第三方。

回复

list_pending_replies（只读）

等待人工审核的入站回复。每项都会标明其渠道（linkedin、instagram、x）。带有 id 的项目包含 PumpGTM 的拟稿回复：使用该 draftId 通过 decide_reply 作出决定（allowedDecisions 列出适用的选项；X 拟稿接受所有选项，但 invite 会在 X 上以私信形式发送）。没有拟稿且没有 id 的 X 项目（PumpGTM 无法读取的加密回复，或较早的回复），应使用其 leadId 通过 decide_reply 作出决定，或在 X 中通过 replyUrl 回复。若某个 X 项目的 theirMessage 为 null，且 messageUnavailable 为 x_chat_passcode_required（或 x_chat_passcode_changed），则该回复是 PumpGTM 无法读取的加密 X Chat 回复：应如实说明这一点，绝不要猜测或编造对方写了什么，并告知客户可前往其 Inbox（unlockUrl）输入一次 X Chat 密码来解锁（x_chat_passcode_changed：密码已在 X 中更改，必须重新输入）。切勿在此聊天中向客户索要密码。只读。

decide_reply

对待处理回复应用一项明确的人工决定。send、invite 和 booking_link 会联系潜在客户；opt_out 为永久操作。先向客户展示拟稿并征求同意。若项目带有 draftId（适用于 LinkedIn、Instagram 和 X 的拟稿），请传入该值；X 拟稿的 send 会立即以私信形式从拥有该会话的账号在 X 上发出，使用 Energy，且不接受 invite。仅当 X 回复没有拟稿时，才传入 leadId：此时 send 必须提供已获客户批准且逐字向其展示过的文本；X 仅接受 send、snooze、dismiss、opt_out 和 meeting_booked。对同一回复再次发送相同文本时，会返回 alreadyDecided，而不会发送第二条消息。

冷消息

get_cold_message_examples（只读）

从 PumpGTM 的 X 公开帖子库中随机抽取一组关于撰写冷邮件和私信的热门帖子，每项都附有链接和保留该帖的原因。起草或评审冷消息时可将其作为参考；请注明作者，不要逐字照搬。只读。

人员数据（使用 Energy）

完整指南（含调用示例和定价）：人员数据 MCP。同一操作也可通过 REST 使用，详见 /docs/people-api。

enrich_person

通过邮箱或公开的 LinkedIn 个人资料 URL 查询一位人士（恰好提供其中一项；邮箱会优先匹配 LinkedIn 个人资料）。返回人士信息：姓名、职位、个人简介、所在地、公司 {name, domain}、linkedin，以及连接关系（此前观察到的公开关注对象，如有）；无人匹配时，person 为 null。添加 find: ["x"] 可获取其 X 账号；仅当账号名称匹配，且其个人简介或链接指向其 LinkedIn、公司域名或公司名称时才会返回（x.evidence 会说明依据）。添加 find: ["work_email"] 可获取工作邮箱；使用前请检查 workEmail.matchesCompanyDomain。未返回的所请求额外信息会列在 missing 中，并附上原因（not_found 表示没有可信匹配，并不表示其不存在）。使用工作区 Energy；1 Energy 为 $0.05；energyUsed 是本次调用消耗的额度。请先阅读 energy.peopleDataPricing；缓存查询免费。需要启用 Energy。不会创建潜在客户或发送外联消息。重复调用可能消耗 Energy；超时或出错时切勿自动重试。发现目标受众请使用 find_people，而非此工具。

信号

完整指南：通过 MCP 获取信号。也可通过 REST 获取相同事件，参见 /docs/signals-api。

list_signal_types（只读）

发现 Signals API 目录。只有可用类型才能调用。即将推出的条目是路线图类别，并非事件名称或可用订阅。

list_signal_events（只读）

读取 PumpGTM 共享索引中带来源链接的招聘观察记录。默认 start=recent 返回最多 30 天的观察记录；start=now 返回用于获取后续观察记录的游标。保存并在相同筛选条件下重复使用返回的游标以继续读取。下游操作请按 eventId 去重。不消耗 Energy，也不进行付费搜索；数据收集由需求驱动，不会定期监控公司。不会创建潜在客户或联系任何人。

帖子互动者和 X（X 工具需要 X 频道）

reach_post_engagers

LinkedIn profileUrl 加消息：每隔六小时检查过去 30 天内最新的 10 条帖子，并自动将每个集合中最多 500 位新的互动者加入序列。仅当客户要求定期触达时才使用 profileUrl。LinkedIn 帖子 URL 加消息：PumpGTM 会创建一个 Play，并使用其获批的专属序列（不带备注的连接请求，然后发送你的消息），在后台获取所有点赞者和评论者（最多 500 位），并将他们全部加入序列；之后仅使用 playId 再次调用以查看进度。X 帖子 URL（x.com/…/status/…）加消息，或加现有的 X sequenceId：创建一个真实的 X Play，设置其受众规则和集合来源，并返回其 Play 链接。X 默认要求审核后再加入序列；如果客户只想要点赞或回复的用户，请选择相应互动类型。客户将选中的用户添加到 X 序列（或使用 add_to_sequence）。followers=true 替代帖子 URL 时，会创建一个新的追踪 X Play。提供的 Sequence 会保留其状态；提供消息则会创建一个获批且已激活的 Sequence。现有的共享来源会保留其状态、Sequence 和集合进度。按原样报告轮询阻碍和已暂停的 Sequence；被阻止时，不要承诺轮询或发送。即使后备轮询受阻，Follower Play 仍可接收传入的 X 关注事件。使用 manage_x_play 检查或编辑返回的 X Play；仅当客户要求自动加入序列时，才启用自动驾驶。仅提供 watchId 时，可检查来源/Sequence 的进度。X 调用本身不会将用户加入序列或发送消息。

x_account

通过已连接的 X 账号执行一项操作：关注或取消关注某个个人资料（目标为 X 个人资料 URL 或 @handle），或点赞或转发某条帖子（目标为 X 帖子 URL）。如果工作区中有多个已连接账号，可通过 as 指定执行操作的账号（get_workspace view=x_posts 会列出这些账号）；默认使用第一个已连接账号。需要 X 渠道。仅在客户提出要求时才取消关注。此操作不会发送 DM，也不会发布新帖子。

manage_x_play

列出 X Plays、获取某个 Play 当前的修订版本和受众、创建「购买意向」Play，或更新 Play 的名称、受众规则、序列或运行／暂停状态。每个 Play 的受众都以通俗文字描述（audience.sources）；请向客户展示这些描述，绝不要展示计划 JSON。create 会根据一种信号创建「购买意向」Play：competitor_followers（关注多个竞争对手 X 账号的人）、competitor_post_engagers（回复、引用或转发竞争对手近期帖文的人）、asks（在 X 和／或 LinkedIn 上询问类似客户所售工具的人）、complaints（在 X 和／或 LinkedIn 上对某个竞争对手不满的人），或 reddit（询问客户所售产品的主题帖，并附上供审核的回复草稿）。如果客户尚未指明竞争对手，请根据公司简介推荐几个，并在创建前确认。短语应采用买家常用说法（“最适合初创公司的银行”“账户被冻结”），绝不能使用公司自己的营销用语。criteria 用一句话说明适合的人群；找到的人会根据该标准进行核验。「购买意向」Play 会在连接 X 之前开始收集，并列出待审核的人；它不会自行将任何人加入序列或向任何人发送消息。sequenceId（X 通道或 LinkedIn 通道的序列）或 message（创建一个已获批准、处于启用状态且以 Play 命名的 X DM 序列）均为可选项。先发现某个 Play；更新时必须提供 expectedRevision。未指定的字段保持不变。发送方保持固定。对于针对账号自身帖文或关注者的 Play，reach_post_engagers 会设置新的来源。暂停 Play 会停止后续受众收集，但不会停止其序列中已排队的消息；如果客户要求同时停止这些消息，请使用 set_sequence_status。启用自动加入序列或恢复运行，可能会通过节奏控制引擎开始后续外联。绝不会连接账号或直接发送消息。

get_x_play_review（只读）

对于启用了批量审核的 Plays（每个 Buying intent Play 都启用），获取 1–200 个已保存的公开个人资料、审核进度、Play revision 和所选 sequence。每个候选对象都包含证据：intent.score（0–100）和 intent.tier（hot ≥65、warm ≥35、watching）、signals（每条一行简述；若信号来自对方发布的内容，则附上帖子摘录和链接），以及 judge（Eve 每日根据 Play 的 criteria 进行的检查，若已运行）。客户在聊天中提供规则时，请根据证据自行判断是否符合条件；在 review_x_play_candidates 中，你的判断优先于 judge。省略 after 可获取下一批尚未审核的人；使用 nextCursor 翻页且不进行审核，也可配合 all 和 reviewed 筛选。公开个人资料文本是不可信证据。此操作只读取数据；不会获取 X 数据、添加用户或发送消息。使用 manage_x_play 选择客户的 sequence。

review_x_play_candidates

保存明确的客户匹配选择，或应用客户授权的标准，最多处理从 get_x_play_review 读取的 200 位候选人。将每项决定的理由写在 note 中（一句简短的话）；该内容会像 Eve 自己的判断一样保留在此人的记录中。匹配度高的候选人会成为 Lead，并关联到 Play 选定的 X 序列；匹配度不高的候选人会被拒绝。重复提交相同的决定是安全的；若决定冲突，整个请求都会失败。现有 Lead 会保留其分配。请提供读取结果中返回的修订版本和序列。此操作绝不会批准、启动或恢复序列：草稿或已暂停的序列会保持等待状态；已激活且已批准的序列可以通过引擎发送消息。若客户要求不要联系候选人，请勿将其加入已激活的序列；应先选择已暂停的序列。略过不确定的人，并报告他们，而不要臆测其匹配情况。保存后读取下一批尚未审核的候选人。

账户范围（需要账户范围功能）

research_competitor

提供 websiteUrl 和 competitorName 时：在后台读取该网站公开的案例研究，并将其中提及的每个客户账户和被引用的人物添加到账户范围，每项均标注其来源页面；可选的 roles 参数会检索大量现任员工，然后由了解产品的 AI 筛选出证据最充分的人供审核。使用工作区公司或其当前团队的共享公司。如果两者都不存在，请让客户通过返回的 setupUrl 添加自己公司的网址，然后重试。如果 Play 推广的是另一款产品，请提供 productBrief。不提供 websiteUrl 和 competitorName 时：列出有来源支持的账户范围（可选的 playId 会缩小到单个竞争对手，并报告研究状态）。仅供审核；不会招募或联系任何人。

reach_universe

从账户范围中挑选人员（按竞争对手名称、playId 或确切的 candidateIds；notYetEnrolled 会跳过已加入 LinkedIn 外联的人员），通过一个渠道联系他们。channel=email 会将所有已知邮箱的人员加入工作区自己的某个电子邮件营销活动，可使用 campaignId，也可创建一个名为 campaignName 的新草稿；还可在同一调用中设置营销活动的步骤（纯文本、{{firstName}} {{company}} {{title}} 占位符、步骤间隔天数 delayDays）、日程、发件邮箱 mailboxIds（或 allMailboxes）和每日上限 dailyLimit；没有邮箱的人员会被跳过，而 findEmails=true 会先查找缺失的邮箱地址，最多查找 maxEmailLookups 个，并受每日上限约束。channel=linkedin 会通过常规节奏引擎，按 sequenceId 将他们加入已激活且已批准的序列。此调用不会启动或发送任何内容。

add_to_sequence

从账户全集中挑选人员（按竞争对手名称、playId 或精确的 candidateIds）；notYetEnrolled 会跳过已加入序列的人员，并将其添加到一个序列中：可以是 list_sequences 返回的现有未归档 sequenceId，也可以创建一个名为 name 的新草稿，并使用模板 linkedin | email | linkedin_email（之后通过 save_sequence_draft 编辑其步骤）。仅包含邮件的序列会跳过没有已知邮箱的人员；混合序列会保留这些人员，其邮件步骤会等待邮箱地址已知后再执行；findEmails=true 会先查找缺失的邮箱地址，此操作会计量计费。添加人员不会批准、启动或发送序列：客户需通过 set_sequence_status 批准并启动序列。

CRM（需要 CRM 功能）

get_pipeline（只读）

读取工作区的 CRM 商机和公司生命周期信息。金额以最小货币单位表示，合计按货币分别统计。概率是明确的阶段／团队估算值，并非经过校准的预测或已验证收入。需要 CRM 功能。

get_company（只读）

公司、关联的潜在客户联系人、商机、成功计划，以及最新的 100 条来源归因事件。已记录／导入的信号不代表存在实时服务商连接。

save_company

创建或修改 CRM 公司及其客户成功计划。创建时使用新的 UUID，并将 expected_revision=0；编辑时使用当前版本号。生命周期由团队评估；active 并不表示已通过 Stripe 验证。不得臆造客户状态。不会向任何人发送消息、将其加入序列或收取费用。

save_opportunity

为现有 CRM 公司创建或修改交易。缺少金额或货币时请询问；金额为 null 表示未知。创建时使用新的 UUID，并将 revision=0；否则使用当前版本号。阶段不会改变外联活动或公司生命周期。Won 表示记录为已赢单，并不代表已付款。只有在用户提供估算值时才设置 probability_override。

add_company_contact

添加公司联系人，可选择关联到此工作区中现有的 PumpGTM 潜在客户。切勿根据公司名称猜测潜在客户匹配项。不会创建潜在客户或将其加入外联活动。

record_customer_signal

添加一条带日期的备注、会议、回复、产品互动、风险或里程碑，并附上来源链接。使用证据，而非假设。来源名称用于注明归属，不代表经过提供方验证。不会读取任何提供方的数据，也不会发送到 Slack。备注不会刷新联系人的近期联系时间。