prospeo-mcp-server

Prospeo MCP サーバー

Prospeo の公式 Model Context Protocol（MCP）サーバーです。AI ツールから B2B リードの検索とエンリッチメントにネイティブにアクセスできます。

Claude、Cursor、Windsurf、Claude Code など、MCP 対応のあらゆるクライアントで動作します。

機能

• 検索候補 — 場所、役職、テクノロジー、業界、NAICS、SIC コードの正式なフィルター値を解決する無料のヘルパーです（クレジットは消費されません）。
• 人物のエンリッチメント — 名前、LinkedIn URL、またはメールアドレスから、仕事用メールアドレスと携帯電話番号を検索します。
• 複数人物の一括エンリッチメント — 1 回の呼び出しで最大 25 人をエンリッチメントします。search_person の標準的な後続処理です。
• 企業のエンリッチメント — 従業員数、業界、売上高、技術スタック、資金調達、ソーシャルリンクを含む企業プロフィール全体を取得します。
• 複数企業の一括エンリッチメント — 名前またはドメインのリストから、1 回の呼び出しで最大 25 社をエンリッチメントします。
• 人物検索 — フィルター（役職、職位、場所、企業規模など）を指定して、Prospeo の専門職データベースを検索します。
• 企業検索 — フィルター（業界、従業員数、テクノロジー、売上高など）を指定して、Prospeo の企業データベースを検索します。
• アカウント情報 — 残りのクレジット数、プラン、更新日を確認します（無料、クレジットは消費されません）。

クイックスタート

オプション 1：ホスト型サーバー（推奨）

Prospeo のホスト型 MCP サーバーに直接接続します。インストールは不要です。

サーバー URL：

https://mcp.prospeo.io

認証は OAuth を利用するか、X-KEY ヘッダーに API キーを指定して行います。Claude.ai、Claude Desktop、その他のリモート MCP クライアントが対応しています。

オプション 2：npx を使用してローカルで実行

サーバーを stdio モードでローカル実行します。Node.js 18 以降が必要です。

Claude Code

claude mcp add prospeo --env PROSPEO_API_KEY=your_api_key -- npx -y @prospeo/prospeo-mcp-server

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "prospeo": {
      "command": "npx",
      "args": ["-y", "@prospeo/prospeo-mcp-server"],
      "env": {
        "PROSPEO_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor / Windsurf

MCP の設定に追加します（クライアントのドキュメントを参照してください）。

{
  "prospeo": {
    "command": "npx",
    "args": ["-y", "@prospeo/prospeo-mcp-server"],
    "env": {
      "PROSPEO_API_KEY": "your_api_key"
    }
  }
}

設定

環境変数

変数	必須	デフォルト	説明
PROSPEO_API_KEY	はい（stdio モード）	—	Prospeo API キーです。app.prospeo.io/api で取得してください。
PROSPEO_API_BASE_URL	いいえ	https://api.prospeo.io	API のベース URL です。従来のエンドポイントもこのベースを基準とします。
PROSPEO_API_V2_PREFIX	いいえ	/api/v2	バックエンドの API_V2_STR と一致させる必要があります。例：/test-api
LOG_LEVEL	いいえ	INFO	ログレベルです。DEBUG、INFO、WARN、ERROR を指定できます。

ツール

バックエンド提供ツール

起動時に、stdio とホスト型 HTTP の両方で、設定された Prospeo API から POST /api/v2/mcp/tools を読み込みます。このテーブルには、ツール名、厳格な入力スキーマ、注釈、 公開エンドポイントのバインディングが含まれます。呼び出しはこれらのスキーマに照らして検証され、呼び出し元の API キーを使用して転送されます。 ホスト型接続ではコンパイル済みの起動時テーブルが共有されますが、 各呼び出しではそれぞれの認証済みキーが保持されます。

このテーブルには、内部ヘルパー、ブラウザツール、レガシーエイリアスを除き、公開バインディングを持つ有効化済みの実装済み正規サーバーツールが含まれます。対応範囲は固定のツール数ではなく、バックエンドのカタログに従います。以下に記載されている8つの互換ツールは引き続き利用できます。正規ツール get_usage_and_credits は get_account_info として引き続き利用できます。

メタデータは、API ベース URL に PROSPEO_API_V2_PREFIX と /mcp/tools を続けた URL から、ユーザー認証情報なしで読み込まれます。 プレフィックスはデフォルトで /api/v2 であり、バックエンドの API_V2_STR と一致している必要があります。/test-api の場合、起動時に POST /test-api/mcp/tools を取得します。生成された呼び出しでは、テーブル内の正確なサーバールートパスが使用されます。プレフィックスが再度追加されることはありません。レガシーツールが既存のルートレベルエンドポイントを引き続き呼び出せるよう、ベース URL は変更しないでください。

API キーを使った呼び出しは、クレジットが課金される可能性を含め、その操作を直接承認します。prospeo/approvalRecommended と prospeo/credits のメタデータを利用すると、クライアントは独自の確認を提示できます。Find Mobile は通常の会員クレジット上限を適用し、レシートとレコードへのリンクを返します。開示された電話番号は、認証済みの製品内で確認できます。スレッド検索では、キー所有者の非公開チャットのみが検索されます。

テーブルを取得または検証できない場合、サーバーは8つの互換ツールを使用して起動し、機能低下の状態を記録します。新たにリリースされたツールを読み込むには、バックエンドカタログのリリース後に MCP プロセスを再起動してください。同じリリース期間内に、バックエンド、Assistant、MCP の利用可能時期を調整してください。

生成されたツールの応答では、公開 JSON 表現が維持されます。ツール呼び出しに失敗すると、MCP の isError: true が設定され、code と message を含む JSON エラーが返されます。

コントラクトを検証するには、バックエンドの公開ツールテストで出力された JSON テーブルを PROSPEO_PUBLIC_TABLE_PATH に設定して、npm test を実行してください。また、npm run build と npm run build:http も実行してください。

search_suggestions

検索を組み立てる前に、正規のフィルター値を解決します。無料のエンドポイントで、クレジットを消費しません。レート制限は毎秒15リクエストです。

ユーザーが場所、テクノロジー、業界、役職、または NAICS／SIC コードに言及した場合は、必ず最初にこれを呼び出してください。文字列を推測すると（例：「SF」と「San Francisco, California, United States」）、検索結果が空になる可能性があります。

対応タイプ： location、job_title、technology、industry、naics、sic。

enrich_person

人物の業務用メールアドレスおよび／または携帯電話番号を検索します。複数の人物をエンリッチする場合は、bulk_enrich_person を使用してください（1レコードあたりのコストは同じで、複数回ではなく1回の呼び出しで済みます）。

必須入力（次のうち1つ以上）：

• linkedin_url — 人物の LinkedIn プロフィール URL
• email — 既知のメールアドレス
• person_id — 以前の search_person の結果から取得
• first_name + last_name + company_name または company_website

bulk_enrich_person

1回の呼び出しで最大25人をエンリッチします。これは search_person の結果に対する標準的な後続処理です。各結果の person_id をレコードとして渡すと、応答内の matched.identifier がその person_id と一致するため、結果を元のリストに結び付けられます。

1レコードあたりのクレジットコストは enrich_person と同じです（マッチしたメールアドレス1件につき1クレジット、マッチしたメールアドレスと携帯電話番号の組み合わせ1件につき10クレジット）。レコードごとに簡潔な応答が返されます（job_history、skills は含まれず、会社概要は短縮されます）。特定の人物の完全なプロフィールが必要な場合は、enrich_person を使用してください。

enrich_company

従業員数、業界、売上高、技術スタック、資金調達状況、ソーシャルリンク、属性、求人情報を含む、会社の詳細なプロフィールを取得します。

必須入力（少なくとも1つ）：

• company_website（推奨、最も正確）
• company_name
• company_linkedin_url
• company_id — 以前の検索結果または enrich 結果から取得

bulk_enrich_company

1回の呼び出しで最大25社の情報を補完します。会社名またはドメインのリスト（CRM エクスポート、アカウントリスト、競合マップなど）がすでにある場合に標準的に使用する検索ツールです。一致した会社ごとに詳細なプロフィールを返します。一致した会社1社につき1クレジットを消費します。identifier は、指定されている場合は company_id がデフォルトとなるため、search_company の結果を引き継いで簡単に利用できます。

search_person

型指定されたフィルターを使用して、Prospeo のプロフェッショナルデータベースを検索します。1ページあたり最大25件の結果を返します。結果1ページにつき1クレジットを消費します。

フィルターには以下が含まれます： person_job_title、person_seniority、person_location_search、company_industry、company_headcount_range、company_technology、person_search、person_name、person_job_change、person_contact_details など。

search_company

型指定されたフィルターを使用して、Prospeo の会社データベースを検索します。1ページあたり最大25件の結果を返します。結果1ページにつき1クレジットを消費します。

フィルターには以下が含まれます： company_industry、company_headcount_range、company_location_search、company_technology、company_revenue、company_funding、company_intent、company_icp、company_lookalike、company_key_execs、company_website_traffic、company_integrations など。

get_account_info

Prospeo アカウントの状況（残りのクレジット、プラン名、更新日、チームの人数）を確認します。無料のエンドポイントで、クレジットは消費されません。

使用例

例1：LinkedIn から相手のメールアドレスを調べる

プロンプト：

linkedin.com/in/johndoe にいる人の仕事用メールアドレスを調べてください

動作： サーバーは LinkedIn URL を使って enrich_person を呼び出し、確認済みの仕事用メールアドレス、現在の役職、会社名、利用可能な場合は電話番号を返します。

例2：アプローチ前に会社を調査する

プロンプト：

stripe.com の詳細なプロフィールを教えてください。従業員数、資金調達、技術スタックなど、すべてお願いします

動作： サーバーはドメインを使って enrich_company を呼び出し、業界、従業員数、売上高の範囲、使用技術、資金調達ラウンド、ソーシャルリンク、本社所在地を返します。

例3：フィルターを使って見込み客リストを作成する

プロンプト：

米国の従業員数50～200人の SaaS 企業で、VP レベルの人を探してください

動作： サーバーは役職レベル、業界、従業員数、所在地のフィルターを使って search_person を呼び出します。1ページあたり最大25人の該当するプロフェッショナルについて、名前、役職、会社、メールアドレス、LinkedIn URL を返します。

例4：特定の技術を使用している会社を探す

プロンプト：

Salesforce を使用していて、従業員数が500人を超える会社を検索してください

動作： サーバーは技術と従業員数のフィルターを使って search_company を呼び出します。該当する会社のドメイン、業界、規模、所在地、技術スタックの詳細を返します。

例5：残りのクレジットを確認する

プロンプト：

Prospeo のクレジットはあといくつありますか？

動作： サーバーは get_account_info を呼び出し、クレジットを消費せずに、現在のプラン、残りのクレジット、更新日、チームの人数を返します。

認証

ホスト型サーバー（mcp.prospeo.io）

ホスト型サーバーは、次の2つの認証方式に対応しています。

1. OAuth 2.0 — Claude.ai と Claude Desktop で使用します。MCP ディレクトリから接続すると、OAuth の同意フローが自動的に処理されます。
2. API キーヘッダー — 直接プログラムからアクセスする場合は、X-KEY ヘッダーに API キーを指定します。

ローカルサーバー（stdio モード）

PROSPEO_API_KEY 環境変数を使って API キーを渡します。サーバーは起動時にキーを検証し、キーがない場合は明確なエラーを表示して終了します。

プライバシーポリシー

プライバシーポリシーをご覧ください：https://prospeo.io/privacy-policy

サポート

• メール：[email protected]
• ヘルプデスク：https://help.prospeo.io
• MCP ドキュメント：https://prospeo.io/mcp-docs
• REST API ドキュメント：https://prospeo.io/api-docs
• 課題：https://github.com/prospeo-v2/prospeo-mcp-server/issues

リリース

main の Actions タブから Publish ワークフローを実行し、patch、minor、major のいずれかを選択します。package.json と server.json のバージョンを更新し、npm と MCP Registry に公開した後、リリースをコミットしてタグ付けします。

ライセンス

MIT