关于 Wiza
Wiza 是通过 Wiza Individual Reveal API,根据 LinkedIn 个人资料 URL 查询手机号码的 MCP 服务。它在一次工具调用中轮询异步查询,并区分处理中与确认未找到。
主要功能
- 01根据资料 URL 查找电话号码
- 02在单次调用中轮询查询状态
- 03区分处理中与未找到
- 04需要调用方提供 API 密钥
适用场景
- 01根据 LinkedIn URL 补充联系人信息
- 02检查号码查询是否仍在处理中
MCP 相关
将 Wiza 电话查询作为 MCP 工具提供,可通过托管网关或本地 stdio 服务运行;调用需提供自己的 Wiza API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/wiza/mcpclaude mcp add --transport http pipeworx-io-wiza https://gateway.pipeworx.io/wiza/mcp{"mcpServers":{"pipeworx-io-wiza":{"type":"http","url":"https://gateway.pipeworx.io/wiza/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-wiza":{"type":"http","url":"https://gateway.pipeworx.io/wiza/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-wiza":{"type":"http","url":"https://gateway.pipeworx.io/wiza/mcp"}}}{"mcpServers":{"pipeworx-io-wiza":{"serverUrl":"https://gateway.pipeworx.io/wiza/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@pipeworx/wiza
通过 Wiza 的个人信息揭示 API(wiza.co),根据 LinkedIn 个人资料 URL 查找某人的手机号码。属于 enrich-waterfall 新增的 enrich_find_phone 查找器轮换(fleet #2860)。
属于 Pipeworx — 一个将 AI Agent 连接到 1765+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成,与上游提供商无关联、未经其认可,也非由其发布。
工具
wiza_find_phone(profile_url, _apiKey)— 发起信息揭示并在调用中轮询(最多约 10 秒,共 5 次轮询),让调用方获得一个同步结果,而不是需要自行管理的裸信息揭示 ID。
身份验证
仅使用自带密钥。将 Wiza API 密钥作为 _apiKey 传入(请求头
Authorization: Bearer <key>)。在 Wiza 账户的 API 页面中查找密钥。无平台密钥(D4)。
数据源
https://wiza.co/api/individual_reveals— 发起信息揭示(POST)并轮询 (GET/individual_reveals/{id}),并设置enrichment_level: "phone"。
验证说明(fleet #2860,2026-10-08,未持有供应商密钥)
- 使用无效密钥对线上端点进行了探测:HTTP 401
{"status":{"code":401,"message":"Invalid API key."}}— 确认了端点、Authorization: Bearer请求头,以及错误密钥会正常失败。 - 信息揭示确实是异步的(Wiza 自己的文档称典型用时为“0-15
秒”,平均“约 4 秒”)——此工具包会在一次工具调用中以 2 秒间隔最多轮询 5 次。我们没有 Wiza 密钥,因此从未针对真实信息揭示测试过此轮询循环及其字段解析(
mobile_phone/phone_number/phones[]、phone_status)——这些内容直接依据 https://docs.wiza.co/using-the-api/find-mobile-phone-number 构建(2026-10-08 阅读)。如果真实信息揭示返回的号码字段名称不同,循环会在尝试 5 次后结束,并报告pending: true的未找到结果,而不是确认未找到——这种区别是有意为之(见下文),但前提是phone_status确实如文档所述出现。 - **待处理与确认未找到是实际区别,并非凑数。**如果 5 次轮询用尽,而 Wiza 尚未设置
phone_status: "not_found",此工具包会返回{ found: false, pending: true, reveal_id },而非直接报告未找到,因为 Wiza 可能仍在处理中——调用方(或工作流)可以决定是否继续等待,而不会被错误告知不存在电话号码。 - 尚未验证(未持有密钥):
phone_status的确切枚举值;phones[]是否可能返回多个号码,以及应优先选择哪种类型。
快速开始
添加到 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"wiza": {
"url": "https://gateway.pipeworx.io/wiza/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/wiza/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 通用元工具——ask_pipeworx、
discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此,你看到的工具数量会多于此表:单工具包端点目前会在工具包自身工具之外列出约 30 个通用工具。连接的 initialize 响应会说明其确切范围,并且是当天适用范围的权威信息。
这是有意为之,并非意外复用。元工具可让范围受限的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——而无需你添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点;如果额外的 schema 占用的上下文超过路由功能带来的价值,请一次连接到完整网关,而不是连接多个工具包端点。
或者连接到完整的 Pipeworx 网关,直接列出所有工具包的工具,而不只是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一个网关和相同的 1765+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出;通过任一端点,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
此工具包需要你提供自己的 API 密钥(_apiKey)——我们不会代你提供,因此这里没有可直接运行的 curl 命令。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/wiza_find_phone。查找工具包:POST https://gateway.pipeworx.io/v1/tools/search_packs,请求内容为 {"query":"..."}。
独立运行(无需网关账户)
此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需经过网关:
{
"mcpServers": {
"wiza": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-wiza"]
}
}
}
或者直接运行,确认它能够启动:
npx -y @pipeworx/mcp-wiza
它通过 stdin/stdout 使用 MCP 通信,并响应 initialize/tools/list/tools/call,但仅支持此工具包中的工具——不包含上方网关连接所添加的任何共享元工具。相同的源代码,相同的工具,无需 ask_pipeworx 路由。
使用 ask_pipeworx
你可以用通俗的英语提问,而不是直接调用工具——这既适用于上方的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Wiza data" })
网关会选择合适的工具,并自动填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。