Icypeas

@pipeworx/icypeas

通过 Icypeas（icypeas.com），根据姓名 + 公司域名/名称查找工作邮箱。 属于 enrich-waterfall 查找器轮换池（fleet #2860）。

属于 Pipeworx — 一个将 AI Agent 连接到 1881+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也不是由其发布。

工具

• icypeas_find_email(first_name?, last_name?, domain_or_company, _apiKey) — 工作邮箱，以及 Icypeas 自带的置信度标签。

身份验证

仅支持自带密钥。将 Icypeas API 密钥作为 _apiKey 传入（请求头 Authorization: Bearer <key>）。在 icypeas.com 控制面板的 API 部分启用 API 访问权限并获取密钥。无平台密钥（D4）。

数据源

• https://app.icypeas.com/api/email-search — 邮箱搜索。

验证说明（fleet #2860，2026-10-08，未持有供应商密钥）——信任解析结果前请先阅读

• Icypeas 文档描述的模型是异步的：供应商自己的文档 （https://api-doc.icypeas.com/find-emails/email-discovery/）将 /email-search 描述为将搜索加入队列，并可选择在“完成时”触发 webhook——这意味着单纯的入队响应本身可能不包含邮箱。我们没有 Icypeas 密钥，因此无法端到端执行真实搜索以查看实际成功响应的结构；未经身份验证的探测也无法通过 401 错误。
• **边缘探测确认的内容：**该端点处于运行状态；不带 Authorization 请求头和使用 Authorization: Bearer invalidkey123，都会返回相同的 HTTP 401 {"message":"The user does not exist","error":"UserNotFoundError","status":401, "code":"user_not_found_error"}——因此请求头名称正确，错误密钥也会如实报错（“用户不存在”），而不会被悄悄忽略。
• 解析器采取了防御性处理，但未经确认：它会读取顶层或 item.results 下的 results 数组，并取第一个 email 非空的条目。这是根据 Icypeas 的 Make/n8n 无代码集成（其中会内联呈现单次搜索结果）推测出的尽力而为的响应结构，并非逐字段确认过的响应。如果此工具包在使用有效密钥时每次调用都返回 found: false，首先应检查 /email-search 是否实际返回了必须通过单独的结果端点轮询的 item._id——这意味着该工具包需要增加第二个轮询步骤，并不代表此人没有邮箱。 特此明确说明，避免解析缺失被误认为普通的“未找到”。
• **未经验证（未持有密钥）：**确切的成功响应结构；是否需要轮询步骤；certainty 字段可能的取值。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "icypeas": {
      "url": "https://gateway.pipeworx.io/icypeas/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/icypeas/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关级工具集中的其余工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出该工具包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，也是当天最权威的答案。

这是有意为之，并非意外的多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——因此你无需再添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义消耗的上下文超过了路由带来的收益，请只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是这个工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和同一批 1881+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）——我们不会为它提供密钥，因此没有不带密钥也能运行的 curl 命令。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/icypeas_find_email。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "icypeas": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-icypeas"]
    }
  }
}

或者直接运行它，确认服务可以启动：

npx -y @pipeworx/mcp-icypeas

它通过 stdin/stdout 使用 MCP 通信，并处理 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。使用相同的源代码和工具，但没有 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你也可以用通俗英语提问，而不是直接调用工具——上述工具包端点和完整网关都支持此功能：

ask_pipeworx({ question: "your question about Icypeas data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT