Rocketreach

@pipeworx/rocketreach

名前と現在の勤務先（または LinkedIn URL／メールアドレス）から、RocketReach（rocketreach.co）経由で人物の電話番号を検索します。enrich-waterfall の新しい enrich_find_phone 検索ローテーションの一部です（フリート #2860）。

Pipeworx の一部です。AI エージェントを 1856+ の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもしていません。

ツール

• rocketreach_find_phone(name?, current_employer?, linkedin_url?, email?, _apiKey) — 電話番号（取得可能な場合は E.164 形式）、回線／種別ラベル、評価、および人物／企業のコンテキスト。

認証

BYO のみです。RocketReach API キーを _apiKey として渡してください（api_key クエリパラメーターとして送信されます）。RocketReach の Account Settings ページでキーを生成してください。プラットフォームキーはありません（D4）。

データソース

• https://api.rocketreach.co/api/v2/person/lookup — lookup_type=phone&reveal_phone=true による人物検索。

検証メモ（フリート #2860、2026-10-08、ベンダーキー未保有）

• キーなしと無効なキーを区別するライブのエッジプローブを実施： api_key なしの場合は HTTP 401 {"detail":"Anonymous requests are not allowed. Please use the test API key.","error_code":"authentication_failed"}、無効なキーの場合は HTTP 401 {"detail":"Invalid API key","error_code":"authentication_failed"} です。エンドポイントとパラメーター名が正しいことを確認しています。
• ベンダーのドキュメントに基づくレスポンス形式（https://docs.rocketreach.co/reference/people-lookup-api、2026-10-08 閲覧）— キーを保有していないため、ライブでの成功した呼び出しは行っていません。ドキュメントの例には、number／e164／type／grade／recommended／country_code を含む phones[] 配列があります。このパックでは recommended: true のエントリーを優先し、該当するものがない場合は最初の電話番号を返します。
• 非同期検索はエラーではなく、仕様として定義された状態です。 status は "complete" ではなく "progress"／"searching" の場合があります。その場合、このパックは単に「見つからない」と報告するのではなく、区別できる { found: false, pending: true, lookup_id } を返します。呼び出し側は、その人物に電話番号がないと判断するのではなく、lookup id を使って再試行する必要があるためです。
• 未検証（キー未保有）： 無料／トライアルプランで reveal_phone: true を指定したときに、完全な番号が返るのか、マスクされた一部の番号が返るのかは未検証です。また、RocketReach が使用する type の値（直通／携帯／その他）の全種類も未検証です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/rocketreach/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 も、同じゲートウェイと同じ 1856+ のデータソースに接続します。違いは、どのパックのツールが直接一覧に表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックではご自身の API キー（_apiKey）を使用します。API キーをこちらで用意していないため、キーなしで実行できる curl の例はありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/rocketreach_find_phone を実行してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

npm から実行する

@pipeworx/mcp-rocketreach は、Pipeworx ゲートウェイへのローカルな stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを、上記と同じ https://gateway.pipeworx.io/rocketreach/mcp エンドポイントに転送します。ネットワークアクセスが必要です。オフラインモードはありません。

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

キーがない場合は匿名で呼び出し、1 日あたり 50 回に制限されます。無料アカウントを作成すると、1 日あたり 200 回まで増えます。https://pipeworx.io/signup でキーを取得し、サーバーエントリに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーはホスト型接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそこでの利用と同様に計測され、課金されます。

デフォルトでは、このパックのツールのみが一覧表示されます。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx やその他のゲートウェイ全体のツールも一覧表示されます。

HTTPS プロキシ経由の場合、Node 組み込みの fetch はデフォルトでは HTTPS_PROXY を読み取りません。新しい Node リリースでは NODE_USE_ENV_PROXY=1 を設定するとこれが有効になります。お使いの Node のバージョンのドキュメントを確認してください。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントと、ゲートウェイ全体のどちらでも使えます。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT