Apollo.io MCP Server

Instructions

Implementation Reference

• src/index.ts:282-290 (handler)

  MCP tool handler for 'get_person_email' that delegates to ApolloClient.getPersonEmail and formats the response as JSON text content.

  case 'get_person_email': {
    const result = await this.apollo.getPersonEmail(args.apollo_id as string);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(result, null, 2)
      }]
    };
  }

• src/index.ts:186-199 (registration)

  Registration of the 'get_person_email' tool in the list of available tools, including name, description, and input schema.

  {
    name: 'get_person_email',
    description: 'Get email address for a person using their Apollo ID',
    inputSchema: {
      type: 'object',
      properties: {
        apollo_id: {
          type: 'string',
          description: 'Apollo.io person ID'
        }
      },
      required: ['apollo_id']
    }
  },

• src/apollo-client.ts:203-236 (helper)

  Core implementation of getPersonEmail method in ApolloClient class that performs the API request to fetch email addresses using the person's Apollo ID.

  async getPersonEmail(apolloId: string): Promise<any> {
    try {
      if (!apolloId) {
        throw new Error('Apollo ID is required');
      }
  
      const baseUrl = `https://app.apollo.io/api/v1/mixed_people/add_to_my_prospects`;
      const payload = {
        entity_ids: [apolloId],
        analytics_context: 'Searcher: Individual Add Button',
        skip_fetching_people: true,
        cta_name: 'Access email',
        cacheKey: Date.now()
      };
  
      const response = await axios.post(baseUrl, payload, { 
        headers: { 
          'X-Api-Key': this.apiKey,
          'Content-Type': 'application/json'
        } 
      });
  
      if (!response.data) {
        throw new Error('No data received from Apollo API');
      }
  
      const emails = (response?.data?.contacts ?? []).map((item: any) => item.email);
      return emails;
    } catch (error: any) {
      console.error(`Error getting person email: ${error.message}`);
      return null;
    }
  }