people_search
Search for professionals by organization domain, job title, and seniority level to identify potential contacts or candidates.
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/index.ts:252-260 (handler)MCP tool handler for 'people_search': dispatches arguments to ApolloClient.peopleSearch and formats response as JSON text.
case 'people_search': { const result = await this.apollo.peopleSearch(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } - src/apollo-client.ts:141-156 (handler)Core implementation of peopleSearch: makes POST request to Apollo.io /mixed_people/search endpoint with query parameters and returns response data.
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 input parameters for peopleSearch query.
export interface PeopleSearchQuery { q_organization_domains_list?: string[]; person_titles?: string[]; person_seniorities?: string[]; [key: string]: any; } - src/index.ts:130-152 (registration)Tool registration in MCP ListTools response, including name, description, and inputSchema matching PeopleSearchQuery.
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' } } } },