`enrich_find_phone`

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_find_phone for the schema, then POST the same URL with its arguments for the data.

Find a person’s phone number by trying your own vendor accounts in order (forager, wiza, rocketreach, peopledatalabs), stopping at the first hit. Pass full_name (+ company) and/or linkedin_url — vendors differ in which they need. Optionally pass _veriphoneKey to add a line-type/carrier check on the winning number via the existing veriphone pack. Every response carries provider_hit, attempts[] with per-attempt cost, and stopped_because. Pipeworx charges 0 credits. Example: enrich_find_phone({ full_name: “Patrick Collison”, company: “Stripe”, linkedin_url: “https://www.linkedin.com/in/patrickcollison/”, _rocketreachKey: “your-rocketreach-key” })

Parameters

Name	Type	Required	Description
`full_name`	string	no	Person’s full name, e.g. “Patrick Collison”. Needed by rocketreach (with company) and peopledatalabs.
`company`	string	no	Company name, e.g. “Stripe”. Used with full_name by rocketreach and peopledatalabs.
`linkedin_url`	string	no	Person’s LinkedIn profile URL. Needed by forager and wiza; usable by rocketreach instead of name+company.
`order`	array	no	Vendor order, tried left to right. Defaults to [“forager”,“wiza”,“rocketreach”,“peopledatalabs”].
`items`	string	no
`stop_on_first_hit`	boolean	no	Default true: stop at the first vendor that returns a number. Set false to query every vendor you supplied a key for.
`_foragerAccountId`	string	no	Your Forager account id (required together with _foragerKey — Forager needs both).
`_foragerKey`	string	no	Your Forager API key.
`_wizaKey`	string	no	Your Wiza API key.
`_rocketreachKey`	string	no	Your RocketReach API key.
`_pdlKey`	string	no	Your People Data Labs API key.
`_veriphoneKey`	string	no	Optional: your Veriphone API key, used only to add a line-type/carrier check on the winning phone number (not part of the vendor waterfall itself).

Example call

Arguments

{
  "full_name": "Patrick Collison",
  "company": "Stripe",
  "linkedin_url": "https://www.linkedin.com/in/patrickcollison/",
  "_rocketreachKey": "your-rocketreach-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_phone","arguments":{"full_name":"Patrick Collison","company":"Stripe","linkedin_url":"https://www.linkedin.com/in/patrickcollison/","_rocketreachKey":"your-rocketreach-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('enrich_find_phone', {
  "full_name": "Patrick Collison",
  "company": "Stripe",
  "linkedin_url": "https://www.linkedin.com/in/patrickcollison/",
  "_rocketreachKey": "your-rocketreach-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_find_phone