`enrich_find_email`

Pack: enrich-waterfall · Endpoint: https://gateway.pipeworx.io/enrich-waterfall/mcp

Find a person’s work email by trying several email-finding vendors in order on YOUR OWN accounts, stopping at the first one that returns an address. Bring your own keys for hunter.io, findymail, People Data Labs or snov.io — Pipeworx never uses a platform key here and charges 0 credits. Returns one normalised answer (email, the vendor that answered, that vendor’s own confidence and what scale it is on, job title, company, LinkedIn URL) plus a per-vendor log of what each attempt did, how long it took, and whether it consumed your quota, so you can retune the order. Reports “not found by any vendor” honestly instead of returning an empty record. Example: enrich_find_email({ full_name: “Patrick Collison”, domain: “stripe.com”, order: [“hunter”, “findymail”], _hunterKey: “your-hunter-key”, _findymailKey: “your-findymail-key” })

Parameters

Name	Type	Required	Description
`full_name`	string	yes	The person’s full name, e.g. “Patrick Collison”. Split into first/last for the vendors that want it that way.
`domain`	string	yes	Company mail domain, no protocol, e.g. “stripe.com”.
`company`	string	no	Company NAME, e.g. “Stripe”. Optional; People Data Labs matches better on a name than a domain. Defaults to the domain.
`order`	array	no	Vendor order, tried left to right. Defaults to [“hunter”,“findymail”,“peopledatalabs”,“snov”]. Put the account with your best hit rate first — attempts[].latency_ms from a previous call tells you what your own accounts actually cost you in time.
`items`	string	no
`stop_on_first_hit`	boolean	no	Default true: stop as soon as a vendor returns an address, so you pay one vendor rather than all of them. Set false to query every vendor you supplied a key for and compare their answers.
`_hunterKey`	string	no	Your hunter.io API key. Omit to skip hunter.
`_findymailKey`	string	no	Your findymail API key. Omit to skip findymail.
`_pdlKey`	string	no	Your People Data Labs API key. Omit to skip PDL.
`_snovKey`	string	no	Your snov.io credentials as “client_id:client_secret”. Omit to skip snov.

Example call

Arguments

{
  "full_name": "Patrick Collison",
  "domain": "stripe.com",
  "order": [
    "findymail",
    "hunter"
  ],
  "_hunterKey": "your-hunter-api-key",
  "_findymailKey": "your-findymail-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_find_email","arguments":{"full_name":"Patrick Collison","domain":"stripe.com","order":["findymail","hunter"],"_hunterKey":"your-hunter-api-key","_findymailKey":"your-findymail-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('enrich_find_email', {
  "full_name": "Patrick Collison",
  "domain": "stripe.com",
  "order": [
    "findymail",
    "hunter"
  ],
  "_hunterKey": "your-hunter-api-key",
  "_findymailKey": "your-findymail-api-key"
});

More examples

{
  "full_name": "Sarah Chen",
  "domain": "google.com",
  "company": "Google",
  "stop_on_first_hit": false,
  "_pdlKey": "your-peopledatalabs-api-key",
  "_hunterKey": "your-hunter-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

enrich_find_email