leadenrich-mcp

LeadEnrich MCP サーバー

AI エージェント向けのウォーターフォール型リード情報拡充です。Apollo、Clearbit、Hunterを順に利用して、1回の呼び出しで最も網羅的なリードプロフィールを作成します。

ワンクリックでインストール： MCPize にインストール | pip install leadenrich-mcp

LeadEnrich MCP は、Model Context Protocol（MCP）を通じてリードと企業の情報拡充を提供するため、ClaudeやCursorなどのツールから情報拡充のワークフローを直接実行できます。メールアドレス、ドメイン、または名前を指定すると、各データ項目をどのプロバイダーが提供したかを示す情報源付きの統合プロフィールを返します。

すばやく接続

1. サーバーをインストールして起動する

pip install leadenrich-mcp
leadenrich-mcp

デフォルトでは、サーバーは http://localhost:8300/mcp で起動します。

2a. Claude Desktop から接続する

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "leadenrich": {
      "url": "http://localhost:8300/mcp"
    }
  }
}

2b. Claude Code から接続する

claude mcp add leadenrich --transport http http://localhost:8300/mcp

ツール

ツール	説明
enrich_lead	単一のリード（メールアドレス、ドメイン、または名前＋ドメイン）の包括的なウォーターフォール型情報拡充
find_email	名、姓、企業ドメインからメールアドレスを特定
enrich_company	ドメインから企業の企業統計データを取得（業種、規模、売上など）
enrich_batch	最大25件のリードを並行して一括で情報拡充
check_usage	割り当て量、コスト追跡、残りの照会回数を確認
health_check	サーバーのステータス、設定済みプロバイダー、キャッシュ統計を確認

仕組み

LeadEnrich はウォーターフォール方式を使用し、各プロバイダーが前のプロバイダーで補えなかった情報を補完します。メールアドレスがわかっている場合は、速度を高めるためにすべてのプロバイダーを並行して実行します。名前＋ドメインのみが指定された場合は、まずApolloがメールアドレスを特定し、その後ClearbitとHunterを並行して実行します。

Input (email / domain / name+domain)
         |
         v
  +-----------+     +-----------+     +----------+
  |   Apollo  | --> |  Clearbit | --> |  Hunter  |
  +-----------+     +-----------+     +----------+
  |  Contact  |     |  Company  |     |  Email   |
  |  Company  |     |  Person   |     |  Verify  |
  |  LinkedIn |     |  Firmo    |     |  Domain  |
  +-----------+     +-----------+     +----------+
         |               |                |
         v               v                v
  +------------------------------------------+
  |        Merged Profile                    |
  |  16+ fields with per-field attribution   |
  |  Confidence score + lookup cost          |
  +------------------------------------------+

結果の各フィールドには情報源が付与されるため、どのプロバイダーから取得したかを正確に確認できます。組み込みのキャッシュにより、APIの重複呼び出しは発生しません。

料金

プラン	料金	詳細
無料	$0.00	月50回の照会
1プロバイダーのヒット	$0.05/照会	1つのプロバイダーがデータを返した場合
2プロバイダーのヒット	$0.10/照会	2つのプロバイダーがフィールドを提供した場合
3プロバイダーのヒット	$0.15/照会	最大範囲をカバーする完全なウォーターフォール

必要条件

• Python 3.11+
• pip

クイックスタート

git clone https://github.com/carsonlabs/leadenrich-mcp.git
cd leadenrich-mcp
pip install -r requirements.txt
python main.py

MCP エンドポイント：

• http://localhost:8300/mcp

環境変数

変数	説明	必須
APOLLO_API_KEY	Apollo.io API キー	いいえ
CLEARBIT_API_KEY	Clearbit API キー	いいえ
HUNTER_API_KEY	Hunter.io API キー	いいえ
LEADENRICH_API_KEY	使用量計測用のクライアント認証キー	いいえ
LEADENRICH_FREE_TIER_LIMIT	無料プランの上限（デフォルト：50）	いいえ
PORT	サーバーポート（デフォルト：8300）	いいえ

すべてのプロバイダーキーは任意です。サーバーは設定されているプロバイダーを使用し、残りはスキップします。

例：

export APOLLO_API_KEY="your-apollo-key"
export CLEARBIT_API_KEY="your-clearbit-key"
export HUNTER_API_KEY="your-hunter-key"
python main.py

実行方法

直接実行：

python main.py

FastMCP CLI 経由で実行：

fastmcp run main.py --transport streamable-http --port 8300

ツールの詳細

enrich_lead

入力：

• email（任意）：連絡先のメールアドレス（最適な識別子）
• domain（任意）：企業のドメイン（例："stripe.com"）
• first_name / last_name（任意）：連絡先の名前（ドメインと組み合わせます）
• providers（任意）：使用するプロバイダーを指定
• api_key（任意）：LeadEnrich API キー

情報源、信頼度スコア、照会コストを含む、統合済みのリードプロフィールを返します。

find_email

入力：

• first_name（必須）：連絡先の名
• last_name（必須）：連絡先の姓
• domain（必須）：会社のドメイン

信頼度スコアと検証ステータスを含む、見つかったメールアドレスを返します。

enrich_company

入力：

• domain（必須）：会社のドメイン

業界、規模、収益、説明、所在地など、会社レベルの企業属性データを返します。

enrich_batch

入力：

• leads（必須）：リードオブジェクトのリスト（最大25件）。各オブジェクトには、メールアドレス、ドメイン、名前を任意で指定できます
• providers（任意）：使用するプロバイダーを限定します
• api_key（任意）：LeadEnrich API キー

一括処理の概要とともに、エンリッチメント済みプロフィールのリストを返します。

check_usage

入力：

• api_key（任意）：LeadEnrich API キー

検索回数、コスト、ティア、残りの利用枠、キャッシュ統計などの利用状況を返します。

health_check

入力はありません。サーバーのステータス、設定済みプロバイダー、キャッシュ統計、バージョン情報を返します。

お試しください

fastmcp list-tools main.py
fastmcp call-tool main.py health_check '{}'
fastmcp call-tool main.py enrich_lead '{"email":"[email protected]"}'
fastmcp call-tool main.py find_email '{"first_name":"Jane","last_name":"Smith","domain":"stripe.com"}'
fastmcp call-tool main.py enrich_company '{"domain":"stripe.com"}'

デプロイ

Smithery

このリポジトリには、Smithery へのデプロイ用に smithery.yaml が含まれています。

1. リポジトリを GitHub にプッシュします
2. Smithery でサーバーを作成または追加します
3. Smithery の接続先として、このリポジトリを指定します

Docker／ホスティングプラットフォーム

Railway、Fly.io、その他のコンテナホスト向けに Dockerfile が含まれています。

# Railway
railway up

# Fly.io
fly launch
fly deploy

プロバイダーの API キーをホスト環境に設定してください。

アーキテクチャ

Agent (Claude, Cursor, etc.)
  -> MCP
LeadEnrich MCP Server (this repo)
  -> Apollo API    (contact + company data)
  -> Clearbit API  (person + firmographic data)
  -> Hunter API    (email finding + verification)

このサーバーは、MCP ツール呼び出しと複数のエンリッチメントプロバイダー API の間をつなぐ変換レイヤーです。キャッシュ、利用状況の計測、ウォーターフォール型のマージロジックを内蔵しています。

Free と Pro の比較

ツール	Free	Pro（$29/mo）
enrich_lead	はい（Hunter のみ）	はい（完全なウォーターフォール：Apollo + Clearbit + Hunter）
check_usage	はい	はい
health_check	はい	はい
find_email	-	はい
enrich_company	-	はい
enrich_batch	-	はい

Free ティアでは、Hunter による単一プロバイダーでの検索を利用できます。Pro では、3 プロバイダーによる完全なウォーターフォール、メール検索、会社情報のエンリッチメント、一括処理が利用可能になります。

MCPize で Pro にアップグレード — $29/mo または $290/yr。

---

Freedom Engineers が開発

関連サービス

• SelfHeal MCP — MCP サーバー向け自己修復プロキシ
• SiteHealth MCP — ウェブサイトの包括的なヘルス監査