Apollo.io MCP Server

Instructions

Implementation Reference

• src/index.ts:112-128 (registration)

  Registration of the 'organization_enrichment' tool in the MCP server's list of tools, including input schema definition.

  {
    name: 'organization_enrichment',
    description: 'Use the Organization Enrichment endpoint to enrich data for 1 company',
    inputSchema: {
      type: 'object',
      properties: {
        domain: { 
          type: 'string', 
          description: 'Company domain' 
        },
        name: { 
          type: 'string', 
          description: 'Company name' 
        }
      }
    }
  },

• src/index.ts:242-250 (handler)

  MCP tool dispatch handler case for 'organization_enrichment' that invokes ApolloClient.organizationEnrichment and formats the response.

  case 'organization_enrichment': {
    const result = await this.apollo.organizationEnrichment(args);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(result, null, 2)
      }]
    };
  }

• src/apollo-client.ts:41-45 (schema)

  TypeScript interface defining the query parameters for organization enrichment (matches tool input schema).

  export interface OrganizationEnrichmentQuery {
    domain?: string;
    name?: string;
    [key: string]: any;
  }

• src/apollo-client.ts:120-135 (handler)

  Core handler implementation that executes the organization enrichment by calling the Apollo.io /organizations/enrich API endpoint.

  async organizationEnrichment(query: OrganizationEnrichmentQuery): Promise<any> {
    try {
      const url = `${this.baseUrl}/organizations/enrich`;
      const response = await this.axiosInstance.get(url, { params: 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;
    }
  }