Back to Browse

Email Waterfall Orchestrator MCP Server

Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Finds and verifies work emails on your own provider keys, with real per-provider spend.

About

Finds and verifies work emails on your own provider keys, with real per-provider spend.

Security Report

4.2
Use Caution4.2High Risk

This MCP server is a thin wrapper around the Apify API for email finding and verification. The code is clean, well-structured, and properly validates inputs with Zod. Authentication is handled correctly via environment variable. The main security considerations are the intentional pass-through of user-provided API keys to Apify and the broad network access required for the API integration, both of which are appropriate to the server's purpose. A minor credential logging risk exists but is mitigated by proper error handling. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

3 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Apify API token from https://console.apify.com/account/integrationsRequired

Environment variable: APIFY_TOKEN

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

Work Email Waterfall MCP Server

npm MCP License: MIT

MCP server for the Mamba Labs Work Email Waterfall actor on Apify.

Give it contacts and your own provider API keys. It finds a work email for each, verifies it, and tells you exactly what each provider cost you.

Tool

find_work_email

Returns one flat row per contact, misses included, plus a summary row carrying the run totals: the address found, which provider found it, its position in the chain, every provider attempted, the verification verdict and its source, and the provider units spent.

Bring your own keys

This is the part that makes it different from a credit-based enrichment tool. Mamba Labs supplies no provider keys, never sees your credits, and never resells them. The run spends from your accounts at your negotiated rates, which is why maxProviderUnits exists and why you should set it.

The tradeoff is honest in both directions: you keep your own pricing and your own provider relationships, and you carry your own spend. What you get back is real attribution rather than a credit count, so you can see which provider actually earned its keep.

Give it providerRates and the run reports dollars at your rate. Leave it empty and it reports units only, because your plan tier is not knowable from here and guessing it would produce a confident wrong number.

What happens to a bad key

Nothing dramatic. Every key is validated for free before any paid call. A provider with no usable key is dropped from the chain and reported, rather than failing the run or silently burning attempts. With no keys at all the run still completes, explains which capabilities were unavailable, and charges nothing.

Verification is not an afterthought

Verification runs after each finder that returns an address, not once at the end, because providers do not agree on what "found" means. An address that one provider calls a hit and a verifier calls undeliverable is a miss, and you want to know that before it reaches a sequencer.

find_work_email

InputTypeNotes
contactsobject[]One object per person. Any of full_name, first_name, last_name, company_domain, company_name, linkedin_url, email. A single contact is an array of one.
providerKeysobjectYour own keys, by provider name. Validated for free before any paid call.
providerOrderstring[]Registry entry ids in call order. Empty means the actor's default chain.
verificationOrderstring[]Verifier entry ids in order. Empty means the actor's default.
maxContactsintegerHard ceiling on contacts processed.
maxProviderUnitsintegerRun-level cap on provider credits spent from your accounts. Strongly recommended.
providerRatesobjectMap of provider or provider.endpoint to your cost per unit, so spend is reported in dollars.
concurrencyHintintegerAdvisory. Real pacing comes from each endpoint's own multi-window rate limits.

More identifiers means a better chance of a hit. Keyed on a LinkedIn URL the top provider measured 13.7 percent against 9.3 percent on name plus domain, on the same 300 contacts in the same hour.

Setup

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

Get a token at console.apify.com/account/integrations. Read-only. Consumes Apify credits per contact submitted and per address found, on top of whatever your own provider keys spend.

Also available

This tool is also exposed by the GTM Suite umbrella server, alongside the rest of the Mamba Labs GTM actors, if you would rather run one server than many.

Built by Mamba Labs.

Reviews

No reviews yet

Be the first to review this server!