`enrich_verify_email`

Pack: enrich-waterfall · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/enrich_verify_email for the schema, then POST the same URL with its arguments for the data.

Verify a single email’s deliverability by trying your own verifier accounts in order (reoon, millionverifier, bounceban, emailable, hunter), stopping at the first verdict. catch_all is ALWAYS reported as its own field; policy decides whether a catch-all (or risky/unknown) result counts as accepted — conservative only accepts a confirmed-valid address, balanced also accepts catch-all, aggressive accepts anything that is not a confirmed invalid/disposable. Every response carries provider_hit, attempts[] with per-attempt cost, and stopped_because. Pipeworx charges 0 credits. Example: enrich_verify_email({ email: “[email protected]”, policy: “balanced”, _reoonKey: “your-reoon-key” })

Parameters

Name	Type	Required	Description
`email`	string	yes	Email address to verify, e.g. “[email protected]”.
`policy`	string	no	Default “balanced”. conservative: only state=“valid” is accepted. balanced: also accepts catch_all. aggressive: accepts everything except invalid/disposable. catch_all is reported regardless of policy.
`order`	array	no	Verifier order, tried left to right. Defaults to [“reoon”,“millionverifier”,“bounceban”,“emailable”,“hunter”].
`items`	string	no
`stop_on_first_hit`	boolean	no	Default true: stop at the first verifier that returns a verdict. Set false to query every verifier you supplied a key for.
`_reoonKey`	string	no	Your Reoon Email Verifier API key.
`_millionverifierKey`	string	no	Your MillionVerifier API key.
`_bouncebanKey`	string	no	Your BounceBan API key.
`_emailableKey`	string	no	Your Emailable LIVE API key (format “live_…”).
`_hunterKey`	string	no	Your hunter.io API key. Required here even though the hunter pack can use a shared key elsewhere — this tool is BYOK-only on every leg.

Example call

Arguments

{
  "email": "[email protected]",
  "policy": "balanced",
  "_reoonKey": "your-reoon-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/enrich-waterfall/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"enrich_verify_email","arguments":{"email":"[email protected]","policy":"balanced","_reoonKey":"your-reoon-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('enrich_verify_email', {
  "email": "[email protected]",
  "policy": "balanced",
  "_reoonKey": "your-reoon-api-key"
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the enrich-waterfall pack

{
  "mcpServers": {
    "enrich-waterfall": {
      "url": "https://gateway.pipeworx.io/enrich-waterfall/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

enrich_verify_email