`revternal_people_search`

Pack: revternal · 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/revternal_people_search for the schema, then POST the same URL with its arguments for the data.

Search Revternal’s people-intelligence index for any person — not just developers — by job title, seniority, location, current company domain, or skills. Returns matching people with name, headline, and profile fields, plus an opaque cursor for the next page. At least one filter is required. Seniority values: entry, senior, manager, director, vp, c_suite, owner, partner. Countries use 3-letter ISO codes (USA, GBR, IND). Use for recruiting, GTM prospecting, and lead research when you have criteria rather than a specific profile. Example: revternal_people_search({ job_titles: [“Software Engineer”], countries: [“USA”], page_size: 5 }).

Parameters

Name	Type	Required	Description
`job_titles`	array	no	Current job titles to match, e.g. [“Software Engineer”, “CTO”]. A single string is also accepted.
`items`	string	no
`seniority`	array	no	Seniority levels to match: entry, senior, manager, director, vp, c_suite, owner, partner.
`items`	string	no
`countries`	array	no	3-letter ISO country codes, e.g. [“USA”, “GBR”]. Common 2-letter codes are auto-converted.
`items`	string	no
`cities`	array	no	City names to match, e.g. [“San Francisco”].
`items`	string	no
`company_domains`	array	no	Current-company website domains, e.g. [“openai.com”].
`items`	string	no
`skills`	array	no	Skills or keywords matched across profile fields, e.g. [“Python”, “FastAPI”].
`items`	string	no
`stealth_founder`	boolean	no	When true, limit results to stealth founders.
`page_size`	number	no	Results per page, 1-100 (default 5).
`cursor`	string	no	Opaque cursor from the previous response (next_cursor) — pass back unmodified to paginate.
`_apiKey`	string	no	Revternal API key (x-api-key). Injected from the platform key when omitted.

Example call

Arguments

{
  "job_titles": [
    "Software Engineer"
  ],
  "countries": [
    "USA"
  ],
  "page_size": 5
}

curl

curl -X POST https://gateway.pipeworx.io/revternal/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"revternal_people_search","arguments":{"job_titles":["Software Engineer"],"countries":["USA"],"page_size":5}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('revternal_people_search', {
  "job_titles": [
    "Software Engineer"
  ],
  "countries": [
    "USA"
  ],
  "page_size": 5
});

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 revternal pack

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

See Getting Started for client-specific install steps.

revternal_people_search