people_search
Search for professionals by organization domain, job title, and seniority level to find relevant contacts for business development and networking.
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:129-152 (registration)Registers the 'people_search' tool in the MCP ListTools handler, defining its 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 CallToolRequestSchema handler for 'people_search': calls ApolloClient.peopleSearch and returns JSON response.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 people_search: makes POST request to Apollo.io /mixed_people/search endpoint with query params.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 method, matching the tool inputSchema.export interface PeopleSearchQuery { q_organization_domains_list?: string[]; person_titles?: string[]; person_seniorities?: string[]; [key: string]: any; }