Wiza について
Wizaは、Wiza Individual Reveal APIを使い、LinkedInプロフィールURLから携帯電話番号を調べるMCPサーバーです。1回のツール呼び出し内で非同期処理をポーリングし、処理中と未検出を区別します。
主な機能
- 01プロフィールURLから電話番号を検索
- 021回の呼び出し内で状態をポーリング
- 03処理中と未検出を区別
- 04呼び出し元のAPIキーが必要
活用シーン
- 01LinkedIn 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
LinkedIn プロフィール URL から、Wiza の個別リビール API(wiza.co)を使用して、人物の携帯電話番号を検索します。enrich-waterfall の新しい enrich_find_phone 検索ローテーション(フリート #2860)の一部です。
Pipeworx の一部です。AI エージェントを 1765 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。
ツール
wiza_find_phone(profile_url, _apiKey)— リビールを開始し、インラインでポーリングします(5 回のポーリングで合計約 10 秒以内)。これにより、呼び出し元は管理が必要なリビール ID だけでなく、同期的な回答を 1 つ受け取れます。
認証
BYO のみです。Wiza API キーを _apiKey として渡してください(ヘッダーは
Authorization: Bearer <key>)。Wiza アカウントの API ページでキーを確認できます。プラットフォームキーはありません(D4)。
データソース
https://wiza.co/api/individual_reveals— リビールを開始(POST)し、ポーリングします(GET/individual_reveals/{id})。enrichment_level: "phone"を指定します。
検証メモ(フリート #2860、2026-10-08、プロバイダーのキーなし)
- 無効なキーでエッジから実環境を確認済み:HTTP 401
{"status":{"code":401,"message":"Invalid API key."}}— エンドポイントとAuthorization: Bearerヘッダー、および不正なキーが適切に失敗することを確認しています。 - リビールは実際に非同期です(Wiza の公式ドキュメントでは、通常「0~15 秒」、平均「約 4 秒」と説明されています)。このパックは 1 回のツール呼び出し内で、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が実際に返されることが前提です。 - 保留中と確認済みの不一致は、単なる水増しではなく実質的な区別です。 Wiza が
phone_status: "not_found"を設定しないまま 5 回のポーリング上限に達した場合、このパックは単純な不一致ではなく{ 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 サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマに必要なコンテキストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。
このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、フル Pipeworx ゲートウェイに接続します。
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL からも、同じゲートウェイと 1765 以上の同じデータソースにアクセスできます。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。
MCP クライアントがありませんか?HTTP 経由で呼び出す
このパックでは独自の API キー(_apiKey)を使用します。こちらで API キーを用意していないため、キーなしで実行できる curl コマンドはありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/wiza_find_phone を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージはローカルの 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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。