mcp-mobile-phone-waterfall-orchestrator について
連絡先リストに対し、独自の Prospeo、Lusha、ContactOut、FullEnrich のキーを順に使って電話番号を検索する MCP サーバーです。Apify で検索用 Actor を実行し、番号の詳細とプロバイダーのクレジット使用量を返します。
主な機能
- 01プロバイダーを順に検索
- 02連絡先リストと単一連絡先に対応
- 03E.164形式の番号と回線情報
- 04報告がある場合の着信拒否フラグ
- 05クレジット使用量と費用上限
活用シーン
- 01連絡先リストの携帯電話番号検索
- 02設定済みの複数プロバイダーの順次試行
- 03番号の国と回線種別の確認
MCP 対応
MCP クライアントに `find_mobile_phone` ツールを提供します。Apify Actor を起動してデータセットを返し、`APIFY_TOKEN` が必要です。プロバイダーキーは任意で、サーバー環境から読み込まれます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @mambalabsdev/mcp-mobile-phone-waterfall-orchestratorAPIFY_TOKENシークレットApify API token from https://console.apify.com/account/integrationsPROSPEO_API_KEYシークレットOptional. Your Prospeo API key.LUSHA_API_KEYシークレットOptional. Your Lusha API key (V3).CONTACTOUT_API_KEYシークレットOptional. Your ContactOut API token.FULLENRICH_API_KEYシークレットOptional. Your FullEnrich API key.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
1掲載時のツール一覧 · 1 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| string | いいえ | 単一連絡先用の簡易入力:メールアドレス。 | |
| contacts | array | いいえ | 検索対象の人物です。各人物について、手元にある識別情報をできるだけ多く指定してください。 |
| full_name | string | いいえ | 単一連絡先用の簡易入力:氏名。 |
| mobile_only | enum | いいえ | trueの場合、固定電話またはVoIP番号は発見済みとみなされず、次のプロバイダーに進みます。回線種別が報告されていない番号は不明として保持されます。デフォルトはtrueです。true | false |
| linkedin_url | string | いいえ | 単一連絡先用の簡易入力:LinkedInプロフィールURL。実行プロセスが開くことはありません。 |
| max_contacts | string | いいえ | この実行で処理する連絡先数の上限です。 |
| company_domain | string | いいえ | 単一連絡先用の簡易入力:会社のドメイン。 |
| max_charge_usd | string | いいえ | この実行に対するApify料金の上限(任意)です。料金が上限を超える場合、その料金が発生する前に実行を停止し、支払い済みの行はすべて保持します。 |
| provider_order | array | いいえ | プロバイダーの呼び出し順です。デフォルトはprospeo、lusha、contactout、fullenrichです。キーがないプロバイダーはスキップされ、その旨が報告されます。 |
| max_provider_credits | string | いいえ | 購入者自身のアカウントでこの実行が消費できるプロバイダークレジットの上限です。上限に達すると、残りの連絡先は課金されずにスキップされます。設定を強く推奨します。 |
詳細
モバイルフォン・ウォーターフォール MCP サーバー
Prospeo、Lusha、ContactOut、FullEnrich の順に、お使いの電話データプロバイダーを呼び出し、いずれかから番号が返されるまで、各連絡先の携帯電話番号を検索します。連絡先ごとに1行で、E.164形式の番号、回線種別、国、プロバイダーが報告する場合は Do Not Call フラグ、使用したプロバイダーのクレジット数が含まれます。
Apify 上で Mobile Phone Waterfall アクター(Actor ID 6OOgPktf7RIa5XCOP)を実行します。
Prospeo の処理は、実際のキーを使ってライブで実行済みです(2026-10-19)。Lusha、ContactOut、FullEnrich の各ステップは、各プロバイダーのドキュメントに記載された API に基づいて実装されていますが、実際のキーを使ったライブ実行はまだ行っていません。各実行サマリーでは、これらが providers_not_live_verified に一覧表示されます。キーは保存されません。
ツール
| ツール | 機能 |
|---|---|
find_mobile_phone | ご自身のプロバイダーキーを使って、連絡先リストの携帯電話番号を検索します |
セットアップ
{
"mcpServers": {
"mamba-mobile-phone-waterfall-orchestrator": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-mobile-phone-waterfall-orchestrator"],
"env": {
"APIFY_TOKEN": "your-apify-token",
"PROSPEO_API_KEY": "optional",
"LUSHA_API_KEY": "optional",
"CONTACTOUT_API_KEY": "optional",
"FULLENRICH_API_KEY": "optional"
}
}
}
}
ツールの実行には APIFY_TOKEN が必要です。プロバイダーキーは任意で、このサーバーの環境から読み込まれるため、モデルのコンテキストを通過することはありません。プロバイダーキーが設定されていない場合、実行は完了し、何も呼び出さず、実行開始料金のみが課金されます。
入力
contacts(各連絡先には full_name、first_name、last_name、company_domain、company_name、linkedin_url、email、id のいずれかを指定)、または単一の連絡先用ショートカット full_name、company_domain、linkedin_url、email。任意の項目:provider_order、mobile_only、max_contacts、max_provider_credits、max_charge_usd。
LinkedIn の URL は識別子としてプロバイダーに渡されます。このサーバーもアクターも URL を開きません。
実行方法
サーバーはアクターの実行を開始し(POST /v2/acts/{id}/runs)、実行タイムアウトを1,800秒として、終了状態になるまでポーリング(GET /v2/actor-runs/{runId})し、データセットを返します。成功しなかった実行は、実行 ID とともにエラーとして返されます。
料金
Apify は、イベントごとの料金を Apify アカウントに請求します。起動イベント、少なくとも 1 つのプロバイダーが呼び出された連絡先ごとの料金、見つかった電話番号ごとの料金です。プロバイダーは、お客様のキーを使って独自のクレジットを請求します。現在の料金については、アクターの料金タブをご覧ください。
ライセンス
MIT。Mamba Labs が開発しました。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。