Email Waterfall Orchestrator

v1.0.2$0.02/resultContact Discovery

Finds work emails by chaining your own provider keys, verifies each result, and returns real per-provider spend instead of hiding it behind a credit abstraction. Bring your own Findymail, Prospeo, Icypeas, Reoon and BounceBan keys.

Install

bash
npx @mambalabsdev/mcp-email-waterfall-orchestrator

Use Cases

  • Who buys it. Bought by teams who already pay for email finders and want to know what each one actually costs them per hit.
  • Clay enrichment column. Replace a stack of single-vendor email finders with one waterfall, and get per-provider cost and hit-rate attribution back.

Features

  • A verified work email, or an honest null
  • Real per-provider attribution, units and latency
  • Observed balance movement, read from each provider
  • 15 flat fields, one row per contact, always
  • Multi-provider chain in the order you set

Input

contactsarrayoptional

The contacts. Each may carry id, full_name, company_domain, linkedin_url. Default: [].

providerKeysobjectoptional

Your own keys. Validated for free before any paid call.

providerOrderarrayoptional

Override the default chain, by registry entry id.

verificationOrderarrayoptional

Override the verifier order. Default: [].

maxContactsintegeroptional

Cap on contacts processed.

maxProviderUnitsintegeroptional

Hard ceiling on provider credits consumed. Set this.

providerRatesobjectoptional

Your per-unit costs, so the summary can report dollars. Default: {}.

concurrencyHintintegeroptional

Contacts in flight at once. Default: 4.

Output schema

json
{
  "contact_id": "your-own-id",
  "input_full_name": "Satya Nadella",
  "input_company_domain": "microsoft.com",
  "email": "satyan@microsoft.com",
  "email_status": "valid",
  "found_by": "findymail.search_business_profile#linkedin_url",
  "chain_position": 1,
  "verification_source": "bounceban",
  "verification_degraded": false,
  "providers_attempted": [
    {"entry": "findymail.search_business_profile#linkedin_url", "outcome": "found", "latency_ms": 812, "units": 1}
  ],
  "provider_units_used": 2,
  "is_summary_row": false
}

Pricing

$0.02per result

Pay-per-event billing on the Apify platform. You are charged only when the actor returns a result. No subscription, no seat license.

Free-tier Apify accounts include monthly free compute. Upgrade for higher concurrency and volume.

Available on

npm