people_search
Find professionals by organization domains, job titles, and seniority levels to identify potential contacts for business development, recruitment, or networking purposes.
Instructions
Use the People Search endpoint to find people
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q_organization_domains_list | No | List of organization domains to search within | |
| person_titles | No | List of job titles to search for | |
| person_seniorities | No | List of seniority levels to search for |
Implementation Reference
- src/apollo-client.ts:138-156 (handler)Core handler function that executes the people_search tool logic by calling the Apollo.io People Search API endpoint.
* Use the People Search endpoint to find people. * https://docs.apollo.io/reference/people-search */ async peopleSearch(query: PeopleSearchQuery): Promise<any> { try { const url = `${this.baseUrl}/mixed_people/search`; const response = await this.axiosInstance.post(url, query); if (response.status === 200) { return response.data; } else { console.error(`Error: ${response.status} - ${response.statusText}`); return null; } } catch (error: any) { console.error(`Error: ${error.response?.status} - ${error.response?.statusText || error.message}`); return null; } } - src/apollo-client.ts:47-52 (schema)TypeScript interface defining the input parameters for the peopleSearch query.
export interface PeopleSearchQuery { q_organization_domains_list?: string[]; person_titles?: string[]; person_seniorities?: string[]; [key: string]: any; } - src/index.ts:129-152 (registration)MCP tool registration defining the 'people_search' tool name, description, and input schema.
{ name: 'people_search', description: 'Use the People Search endpoint to find people', inputSchema: { type: 'object', properties: { q_organization_domains_list: { type: 'array', items: { type: 'string' }, description: 'List of organization domains to search within' }, person_titles: { type: 'array', items: { type: 'string' }, description: 'List of job titles to search for' }, person_seniorities: { type: 'array', items: { type: 'string' }, description: 'List of seniority levels to search for' } } } }, - src/index.ts:252-259 (handler)MCP server request handler that dispatches to the ApolloClient peopleSearch method and returns formatted response.
case 'people_search': { const result = await this.apollo.peopleSearch(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };