mcp-email-waterfall-orchestrator

Work Email Waterfall MCP Server

Apify の Mamba Labs Work Email Waterfall アクター向けの MCP サーバーです。

連絡先と、お持ちのプロバイダー API キーを渡すと、それぞれの勤務先メールアドレスを検索して検証し、各プロバイダーにかかった費用を正確に知らせます。

ツール

find_work_email

見つからなかった連絡先も含め、連絡先ごとにフラットな行を返します。さらに、実行全体の合計を含むサマリー行も返します。見つかったアドレス、見つけたプロバイダー、チェーン内の位置、試行したすべてのプロバイダー、検証結果とその情報源、使用したプロバイダーのユニット数が含まれます。

独自のキーを使用

これが、クレジット制のエンリッチメントツールと異なる点です。Mamba Labs がプロバイダーのキーを提供することはなく、お客様のクレジットを見ることも、再販売することもありません。実行時の費用は、お客様のアカウントからお客様が交渉した料金で発生します。そのため、maxProviderUnits が用意されており、設定することをおすすめします。

トレードオフは明確です。お客様は独自の料金とプロバイダーとの関係を維持できる一方、費用もご自身で負担します。その代わり、クレジット数ではなく実際のプロバイダーごとの内訳が分かるため、どのプロバイダーが実際に役立ったのかを確認できます。

providerRates を渡すと、お客様の料金に基づいて金額を報告します。空のままにすると、ユニット数のみを報告します。お客様のプランの階層はここからは分からず、推測すると自信満々に誤った金額を返すことになるためです。

無効なキーを指定した場合

特に問題は起きません。有料の呼び出しを行う前に、すべてのキーを無料で検証します。使用可能なキーがないプロバイダーはチェーンから除外され、そのことが報告されます。実行が失敗したり、知らないうちに試行が消費されたりすることはありません。キーがまったくなくても実行は完了し、利用できなかった機能を説明します。費用も発生しません。

検証は後回しにしません

アドレスを返した各ファインダーの後に検証を行います。最後に一度だけ検証するのではありません。プロバイダーによって「見つかった」の定義が異なるためです。あるプロバイダーがヒットとしたアドレスを検証ツールが配信不能と判定した場合、それは見つからなかったものとして扱います。シーケンサーに渡る前に、そのことを把握しておく必要があります。

find_work_email

入力	型	備考
contacts	object[]	人物ごとに 1 つのオブジェクトを指定します。full_name、first_name、last_name、company_domain、company_name、linkedin_url、email のいずれかを指定できます。連絡先が 1 件の場合も、要素が 1 つの配列にします。
providerKeys	object	プロバイダー名ごとの、お客様自身のキーです。有料の呼び出しを行う前に無料で検証されます。
providerOrder	string[]	呼び出し順に並べたレジストリーエントリー ID です。空の場合は、アクターのデフォルトのチェーンを使用します。
verificationOrder	string[]	順番に並べた検証ツールのエントリー ID です。空の場合は、アクターのデフォルトを使用します。
maxContacts	integer	処理する連絡先数の上限です。
maxProviderUnits	integer	お客様のアカウントから使用するプロバイダーのクレジット数の実行単位の上限です。強くおすすめします。
providerRates	object	支出額をドルで報告するための、プロバイダーまたは provider.endpoint ごとのユニットあたりの費用です。
concurrencyHint	integer	目安となる値です。実際の呼び出し間隔は各エンドポイント独自の複数時間枠のレート制限によって決まります。
max_charge_usd	number	この実行に適用する任意の米ドル建て費用上限です。費用がこの金額を超える可能性のある項目を処理する前に、アクターは停止します。

識別情報が増えるほど、ヒットする可能性が高まります。同じ時間帯に同じ 300 件の連絡先を対象にした場合、LinkedIn URL をキーにすると、上位のプロバイダーでは 13.7％の結果率となり、名前とドメインを使った場合の 9.3％を上回りました。

セットアップ

{
  "mcpServers": {
    "mamba-email-waterfall-orchestrator": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-email-waterfall-orchestrator"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

console.apify.com/account/integrationsでトークンを取得してください。呼び出しのたびに、ご自身のプロバイダーアカウントの利用分が消費され、送信した連絡先ごと、および見つかったメールアドレスごとにApifyクレジットが消費されます。これに加えて、ご自身のプロバイダーキーの利用料金も発生します。

料金

ApifyのFREEプランにおけるイベントごとの料金です。ライブの料金記録に基づいています。有料のApifyプランでは、イベントごとの料金が安くなります。

イベント	料金（USD）
Actorの起動（apify-actor-start）	0.00005
メール検索の送信（email-search-submitted）	0.003
メールアドレスの検出（email-found）	0.02

こちらでも利用できます

このツールは、GTM Suite統合サーバーからも利用できます。多数のサーバーではなく1つのサーバーを実行したい場合は、ほかのMamba LabsのGTM Actorとあわせてご利用ください。

Mamba Labsが開発しました。