LeadPipe MCP

Model Context Protocol（MCP）向けのAI活用型リード評価エンジン

License: MIT TypeScript MCP

LeadPipeは、あらゆるソースからリードを取り込み、企業データでエンリッチメントを行い、設定可能なAIルールを使用して0〜100でスコアリングし、評価済みのリードをCRMにエクスポートします。これらすべてをMCPプロトコル経由で実行可能です。

機能

リードの取り込み: Webhook、フォーム、API、またはCSVから（単一または最大100件のバッチ処理）
自動エンリッチメント: 企業データ（業種、規模、国、技術スタック）をHunter.ioまたはドメインヒューリスティック経由で付与
AIスコアリングエンジン: 6つの重み付けされたディメンションとカスタムルールによるスコアリング（0〜100）
CRMエクスポート: HubSpot、Pipedrive、Googleスプレッドシート、CSV、またはJSONへの出力
パイプライン分析: リアルタイムの統計、スコア分布、コンバージョン率の表示
設定可能: スコアリングの重み付け、高価値な役職/業種、カスタムルール
8つのMCPツール + 3つのMCPリソース: リードのライフサイクル全体をカバー

クイックスタート

MCPizeマーケットプレイスからインストール

mcpize.comでLeadPipe MCPを検索
Installをクリックし、サブスクリプションプランを選択
MCP互換クライアント（Cursor、VS Codeなど）でツールとリソースが自動的に利用可能になります

ソースからビルド

git clone https://github.com/enzoemir1/leadpipe-mcp.git
cd leadpipe-mcp
npm ci
npm run build

MCPクライアント設定に追加:

{
  "mcpServers": {
    "leadpipe": {
      "command": "node",
      "args": ["path/to/leadpipe-mcp/dist/index.js"]
    }
  }
}

ツール

lead_ingest

パイプラインに単一のリードを追加します。

{
  "email": "jane@acme.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "job_title": "VP of Engineering",
  "company_name": "Acme Corp",
  "company_domain": "acme.com",
  "source": "website_form",
  "tags": ["demo-request"]
}

lead_batch_ingest

1〜100件のリードを一度に追加します。重複は自動的にスキップされます。

{
  "leads": [
    { "email": "lead1@corp.com", "job_title": "CEO" },
    { "email": "lead2@startup.io", "job_title": "CTO" }
  ]
}

lead_enrich

メールアドレスのドメインを使用して、リードに企業データを付与します。

{ "lead_id": "uuid-of-lead" }

戻り値: 企業名、業種、規模、国、技術スタック、LinkedIn URL。

lead_score

評価スコア（0〜100）を計算します。スコアが60以上のリードは**評価済み（qualified）**とマークされます。

{ "lead_id": "uuid-of-lead" }

戻り値: スコア + 6つのディメンションごとの詳細な内訳。

lead_search

ページネーションを使用してリードを検索・フィルタリングします。

{
  "query": "acme",
  "status": "qualified",
  "min_score": 60,
  "limit": 20,
  "offset": 0
}

lead_export

リードをCRMまたはファイル形式にエクスポートします。

{
  "target": "hubspot",
  "min_score": 60
}

ターゲット: hubspot, pipedrive, google_sheets, csv, json

pipeline_stats

パイプラインの分析を取得します。入力は不要です。

戻り値: リード総数、ステータス/ソース別の内訳、平均スコア、スコア分布、コンバージョン率、今日/今週/今月のリード数。

config_scoring

スコアリング設定を表示または更新します。

{
  "job_title_weight": 0.30,
  "high_value_titles": ["ceo", "cto", "vp", "founder"],
  "custom_rules": [
    {
      "field": "company_industry",
      "operator": "equals",
      "value": "fintech",
      "points": 15,
      "description": "Bonus for fintech companies"
    }
  ]
}

リソース

リソース	説明
`leads://recent`	最近追加されたリード50件
`leads://pipeline`	ステータス数、スコア、コンバージョン率を含むパイプラインの概要
`leads://config`	現在のスコアリングエンジンの設定

スコアリングエンジン

リードは6つのディメンションの加重平均を使用して0〜100でスコアリングされます:

ディメンション	デフォルトの重み	仕組み
役職	25%	Cレベル/創業者: 100, VP/部長: 85, マネージャー: 65, シニア: 50, ジュニア: 15
企業規模	20%	推奨規模（11-50, 51-200, 201-500）: 90, その他はそれに応じてスケーリング
業種	20%	高価値業種（SaaS, フィンテック等）: 90, その他: 40
エンゲージメント	15%	電話番号の有無、氏名、タグ、ソースタイプ（ランディングページ > CSV）
最新性	10%	今日: 100, 先週: 75, 先月: 35, 3ヶ月以上前: 5
カスタムルール	10%	ユーザー定義ルール（各-50〜+50ポイント）

計算式: score = sum(dimension_score * weight)

スコアが60以上のリードは評価済み、60未満は評価対象外となります。

CRM連携

HubSpot

HUBSPOT_API_KEY環境変数にHubSpotプライベートアプリのアクセストークンを設定してください。

export HUBSPOT_API_KEY="pat-xxx-xxx"

Pipedrive

PIPEDRIVE_API_KEY環境変数を設定してください。

export PIPEDRIVE_API_KEY="xxx"

Googleスプレッドシート

GOOGLE_SHEETS_CREDENTIALSにサービスアカウントのJSONを設定してください。

CSV / JSON

設定は不要です。エクスポート時に直接データが返されます。

エンリッチメント

LeadPipeはリードのメールアドレスからドメインを抽出し、企業データを検索します:

Hunter.io (HUNTER_API_KEYが設定されている場合) — 組織、業種、国、技術スタックを返します
ドメインヒューリスティック — 既知のドメインを企業データにマッピングします
フリーメール検出 — gmail.comやyahoo.comなどはフラグが立てられます（企業エンリッチメントは行われません）

料金

プラン	価格	リード数/月	機能
Free	$0	50	基本スコアリング、Webhook取り込み
Pro	$20/月	500	AIスコアリング、エンリッチメント、メール通知
Business	$40/月	5,000	CRM同期、パイプライン分析、カスタムルール

MCPizeマーケットプレイスで利用可能です。

開発

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run unit tests
npm run inspect    # Open MCP Inspector

ライセンス

MITライセンス。詳細はLICENSEを参照してください。

Automatia BCNによって構築されました。

leadpipe-mcp