apollo_search_people
Pack: apollo · 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/apollo_search_people for the schema, then POST the same URL with its arguments for the data.
Requires a PAID Apollo plan (the free plan answers 403).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
titles | array | no | Job titles to match, e.g. [“VP of Sales”, “Head of Growth”]. Matches on contained terms too (e.g. “marketing manager” also matches “content marketing manager”). |
items | string | no | |
seniorities | array | no | Apollo seniority levels: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. |
items | string | no | |
domains | array | no | Employer domains, no protocol, e.g. [“apollo.io”]. |
items | string | no | |
organization_ids | array | no | Apollo company ids (from apollo_search_organizations results). |
items | string | no | |
person_locations | array | no | Person’s own location, e.g. [“California, US”]. |
items | string | no | |
organization_locations | array | no | Employer’s HQ location. |
items | string | no | |
q_person_name | string | no | Search by person name. |
q_keywords | string | no | Free-text keyword search. |
page | number | no | Page number, default 1. |
per_page | number | no | Results per page, default 10, max 100. |
_apiKey | string | yes | Your Apollo API key. Get one at https://docs.apollo.io/docs/create-api-key. |
Example call
Arguments
{
"titles": [
"VP of Sales"
],
"seniorities": [
"vp"
],
"domains": [
"apollo.io"
],
"_apiKey": "your-apollo-api-key"
}
curl
curl -X POST https://gateway.pipeworx.io/apollo/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"apollo_search_people","arguments":{"titles":["VP of Sales"],"seniorities":["vp"],"domains":["apollo.io"],"_apiKey":"your-apollo-api-key"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('apollo_search_people', {
"titles": [
"VP of Sales"
],
"seniorities": [
"vp"
],
"domains": [
"apollo.io"
],
"_apiKey": "your-apollo-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 apollo pack
{
"mcpServers": {
"apollo": {
"url": "https://gateway.pipeworx.io/apollo/mcp"
}
}
}
See Getting Started for client-specific install steps.