Icypeas

@pipeworx/icypeas

Icypeas（icypeas.com）を通じて、名前と会社のドメイン／社名から勤務先メールアドレスを検索します。 enrich-waterfall ファインダーのローテーションの一部です（フリート #2860）。

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

ツール

• icypeas_find_email(first_name?, last_name?, domain_or_company, _apiKey) — Icypeas 独自の確度ラベル付きで勤務先メールアドレスを検索します。

認証

BYO のみです。Icypeas API キーを _apiKey として渡します（ヘッダー Authorization: Bearer <key>）。API アクセスを有効にして、icypeas.com ダッシュボードの API セクションからキーを取得してください。プラットフォームキーはありません（D4）。

データソース

• https://app.icypeas.com/api/email-search — メールアドレス検索。

検証メモ（フリート #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 を返し、別の結果エンドポイントでポーリングする必要があるかどうかです。その場合、 このパックにはポーリングのステップをもう1つ追加する必要があり、対象者にメールアドレスがないという 意味ではありません。解析の欠落がありふれた「見つかりませんでした」と受け取られないよう、 ここで明示しています。
• 未検証（キー未所持）：正確な成功時の応答形式、ポーリングが必要かどうか、certainty フィールドの取り得る値。

クイックスタート

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

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

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

https://gateway.pipeworx.io/icypeas/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、およそ30個の共有ツールが一覧表示されます。接続の initialize レスポンスには正確なスコープが記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体に振り分ける ask_pipeworx を通じて回答できます。そのため、2つ目の 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 を使用します。ツールを探すには、POST https://gateway.pipeworx.io/v1/tools/search_packs と {"query":"..."} を使用します。

単独で実行（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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