Coresignal MCP

Coresignal MCP v2

Coresignal の公式 Model Context Protocol サーバーです。8億9,500万人以上の従業員、7,000万社以上の企業、4億6,800万件以上の求人情報に関する最新の B2B データを、AI アシスタントに直接取り込めます。

https://mcp.coresignal.com/mcp/v2

Claude、Cursor、Codex、VS Code など、MCP 対応クライアントから、自然な言葉で検索したり、完全なレコードを取得したり、確認済みのメールアドレスで連絡先情報を補完したり、大量の検索結果をダウンロード可能なファイルとしてエクスポートしたりできます。

機能

• OAuth 2.1 認証 — Coresignal ダッシュボードのアカウントでサインインできます。設定ファイルに API キーを記述する必要はありません。
• 自然言語検索 — 各検索結果の行に一致根拠が含まれるため、各レコードが一致した理由を確認できます。
• コストの透明性 — すべての応答に credits_consumed が記載され、コストのかかる呼び出しではクレジットを消費する前に確認を求めます。
• フィールドの検索 — entity_fields を使うと、キーワードから適切なフィールド名を無料で見つけられます。300 以上のフィールド名をすべてコンテキストに読み込む必要はありません。
• ファイルのダウンロード — 大量の検索結果はサーバー側に保存され、チャットに大量のデータを流し込む代わりに、ダウンロードリンクが返されます。
• artifact_read — 配信されたファイルをページ単位で会話に取り込みます。無料で利用でき、ファイルシステムにアクセスできないクライアントでも動作します。

前提条件

• 有効なサブスクリプション（クレジット）と、ダッシュボードで発行したチーム API キーを持つ Coresignal アカウント。サインイン後、MCP サーバーがチームのキーを自動で取得するため、設定ファイルに貼り付ける必要はありません。まだサブスクリプションをお持ちでない場合は、7 日間の無料トライアルから始められます。2,000 クレジットが含まれています。プランの比較をご覧ください。

初回接続時に、クライアントがブラウザーウィンドウを開き、Coresignal ダッシュボードへのサインインを促します。設定はこれだけです。環境変数やシークレットは必要ありません。

クライアントのセットアップ

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

opencode mcp auth coresignal

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

cline mcp

ファイルのダウンロードとドメイン許可リスト

大きな結果（および delivery="url" を指定したすべての呼び出し）は、LLM の入力トークンを節約するため、チャットには出力されません。代わりに、サーバーが行をファイルとして保存し、1 時間後に有効期限が切れる署名付き HTTPS ダウンロードリンクを返します。

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

ここから、エージェントは次の 3 つの方法のいずれかでデータを取得します。

1. エージェント自身がファイルをダウンロードする — シェルアクセスが可能なクライアントでは、通常、エージェントはリンクを curl でディスクに保存し、grep／jq／pandas を使ってローカルでファイルを分析します。
2. エージェントがチャット内で読み戻す — シェルもファイルシステムも使えないクライアントでは、代わりにエージェントが artifact_read(artifact_name, offset, limit) を呼び出し、MCP セッション経由でファイルを分割して読み込みます。これは無料で、どこでも使えるため、チャットが大量の内容であふれることはありません。
3. 手動でダウンロードする — エージェント自身がリンクを取得できない場合（ドメインが許可リストにない、またはサンドボックスでネットワークにアクセスできない場合）は、リンクをクリックしてファイルを保存し、ファイルの場所をエージェントに伝えます。「ファイルを ~/Downloads/employee_fetch-….jsonl にダウンロードしました。そこから分析してください。」 と伝えてください。ローカルファイルを読み取れるクライアントなら、どれでも使えます。

クライアントが対応している場合は、ダウンロードを優先してください。 artifact_read は Coresignal クレジットを消費しませんが、LLM のトークンは消費します。返された各ページが会話の一部となり、以降のターンごとに入力トークンとして再計上されるためです。また、各ページは固定のトークン上限に合わせて切り詰められます。従業員レコード 1 件で約 8k トークンを使うため、指定した limit にかかわらず、1 ページに含められる完全なレコードはごくわずかです。この方法で大きなファイルを読むには何百回も呼び出すことになり、最後まで読み切る前にコンテキストウィンドウを使い果たすおそれがあります。ファイルをダウンロードすれば、トークンは実質的に消費されません。アシスタントは grep／jq を使ってローカルで数千行を絞り込み、回答だけを提示できます。そのため、最初にダウンロードを使えるようにしておき（ドメイン許可リスト、サンドボックスのネットワークアクセス）、ダウンロードできないクライアントや数行をざっと確認する場合に artifact_read を使うのがおすすめです。

ダウンロードがブロックされても、データは失われません。 レコードはすでに保存され、料金も支払い済みです。artifact_read で読み取ってください。ファイルを「復元」するために、フェッチを再実行してはいけません。すべてのレコードについて二重に課金されます。

ツール

entity_search

平易な自然言語のクエリで、employee、company、または job のレコードを検索します。

「フランス語ができるフィンテック企業のシニア Python 開発者」

呼び出し 1 回につき一律 20 クレジットかかり、次の情報が返されます。

• total_count — クエリに一致したレコードの正確な件数。
• 最大 20 件のプレビュー行（limit=0 では件数のみを返します）。各行には、クエリに一致したフィールド、つまり各結果が含まれる理由を示す根拠が表示されます。
• cache_id — 検索結果を 1 時間参照できるハンドルで、クレジットと時間を節約できます。これを entity_fetch に渡すと、一致したレコードをすぐに取得できます。検索を再実行（および再課金）する必要はなく、cache_id 自体の解決も無料です。レコード ID はサーバー側に保持されるため、サイズの大きなデータが会話に流れることはありません。

entity_fields

意味に基づいてフィールド名を即座に無料で検索できます。"salary" で報酬関連のフィールドが見つかり、"current job title and seniority" で active_experience_title、experience.position_title などが見つかります。フィールド名の全リストをコンテキストに読み込まずに、カスタム範囲のフェッチに使う fields リストを作成するために利用してください。

entity_fetch

レコードを取得します。検索結果から手動で選んだ ID を最大 20 件取得するか、cache_id を使って 1 回の呼び出しにつき最大 1,000 件のレコードを取得できます。課金は見つかったレコードごとに発生します。従業員・企業は 20 クレジット、求人は 1 クレジットです。

email_enrich

最大 1,000 件の従業員 ID について、検証済みで配信可能なビジネスメールアドレスを取得します。見つかったメールアドレス 1 件につき 10 クレジットです。見つからなかった ID は無料です。EEA／英国の連絡先にはアクセスできません（GDPR）。

artifact_read

認証済み MCP セッションを介して、配信されたファイルを 1 ページずつ読み取ります。レコードの取得時に課金済みのため、無料です。これにより、リンクを開いたりファイルシステムにアクセスしたりできないチャットクライアントを含め、どこでもファイルを受け取れます。

プロンプトの例

市場調査

「過去 2 年間に資金調達を行った、従業員数 50～200 人の北欧の B2B SaaS 企業を探してください。」

検証済みメールアドレス付きの見込み客リストを作成する

「従業員数 500 人以上の米国企業で、データ部門の責任者を検索してください。検証済みメールアドレス付きの完全なプロフィールを 20 件、ファイルに取得してください。」

1 社を詳しく調べる**

「flo.health の完全なレコードを取得してください。資金調達ラウンド、従業員数の推移、現在の求人情報も含めてください。」

...

クレジットと課金

すべてのレスポンスに credits_consumed が含まれます。これは実際に課金された量を示すため、差異（ID を 1,000 件送信したのに、950 件分が課金された場合）から、見つからなかった ID の数が正確にわかります。サーバーが通知なくクレジットを消費することはありません。取得前にフィールドの範囲を確認し、ファイルを配信できない場合は、クレジットを消費する前に取得が失敗します。

クレジットはチームの Coresignal サブスクリプションから引き落とされます。ダッシュボードでキーと課金を管理できます。Coresignal を初めてご利用ですか？7 日間の無料トライアルには 2,000 クレジットが付属します。検索なら 100 回、従業員・企業レコードなら 100 件、またはその組み合わせに利用できます。プランの比較をご覧ください。

リンク

• Coresignal — データのカバレッジ、プラン、料金
• Coresignal ダッシュボード — アカウント、チーム、API キー、クレジット
• API ドキュメント — 基盤となるデータ API