AgentX MCP server for Apollo.io API with comprehensive people and organization enrichment capabilities
npm install @agentx-ai/apollo-io-mcp-serverA powerful Model Context Protocol (MCP) server implementation for seamless Apollo.io API integration, enabling AI assistants to interact with Apollo.io data for people and organization enrichment.
- People Enrichment: Enrich contact data with comprehensive information
- Organization Enrichment: Get detailed company information and insights
- People Search: Find people based on various criteria
- Organization Search: Discover companies matching specific criteria
- Job Postings: Access job postings for specific organizations
- Email Discovery: Get email addresses using Apollo.io person IDs
- Company Employees: Find employees of specific companies
``bash`
npm install @agentx-ai/apollo-io-mcp-server
``
npm install -g .
npx @modelcontextprotocol/inspector apollo-io-mcp-server
Then add APOLLO_IO_API_KEY in Environment Variable
Enrich contact data with comprehensive information.
Parameters:
- first_name (string): Person's first namelast_name
- (string): Person's last nameemail
- (string): Person's email addressdomain
- (string): Company domainorganization_name
- (string): Organization namelinkedin_url
- (string): Person's LinkedIn profile URL
Get detailed company information and insights.
Parameters:
- domain (string, required): The domain of the company that you want to enrich. Do not include www., the @ symbol, or similar (e.g., 'apollo.io' or 'microsoft.com')
Find people based on various criteria with comprehensive filtering options.
Parameters:
- person_titles (array): Job titles held by the people you want to find (e.g., 'sales development representative', 'marketing manager', 'research analyst')include_similar_titles
- (boolean): Whether to include people with similar job titles (default: true)q_keywords
- (string): A string of words to filter the resultsperson_locations
- (array): The location where people live (e.g., 'california', 'ireland', 'chicago')person_seniorities
- (array): Job seniority levels (e.g., 'owner', 'founder', 'c_suite', 'partner', 'vp', 'head', 'director', 'manager', 'senior', 'entry', 'intern')organization_locations
- (array): The location of the company headquarters for a person's current employer (e.g., 'texas', 'tokyo', 'spain')q_organization_domains_list
- (array): The domain name for the person's employer (e.g., 'apollo.io', 'microsoft.com')contact_email_status
- (array): Email statuses to filter by (e.g., 'verified', 'unverified', 'likely to engage', 'unavailable')organization_ids
- (array): Apollo IDs for specific companies (employers) to include in search resultsorganization_num_employees_ranges
- (array): Employee count ranges for the person's current company (e.g., '1,10', '250,500', '10000,20000')revenue_range
- (object): Revenue range for the person's current employermin
- (integer): Minimum revenue the person's current employer generates (no currency symbols, commas, or decimals)max
- (integer): Maximum revenue the person's current employer generates (no currency symbols, commas, or decimals)currently_using_all_of_technology_uids
- (array): Find people based on ALL technologies their current employer uses (use underscores for spaces, e.g., 'salesforce', 'google_analytics', 'wordpress_org')currently_using_any_of_technology_uids
- (array): Find people based on ANY of the technologies their current employer uses (use underscores for spaces, e.g., 'salesforce', 'google_analytics', 'wordpress_org')currently_not_using_any_of_technology_uids
- (array): Exclude people based on technologies their current employer uses (use underscores for spaces, e.g., 'salesforce', 'google_analytics', 'wordpress_org')q_organization_job_titles
- (array): Job titles listed in active job postings at the person's current employer (e.g., 'sales manager', 'research analyst')organization_job_locations
- (array): Locations of jobs being actively recruited by the person's employer (e.g., 'atlanta', 'japan')organization_num_jobs_range
- (object): Range for number of job postings active at the person's current employermin
- (integer): Minimum number of active job postings at the person's current employermax
- (integer): Maximum number of active job postings at the person's current employerorganization_job_posted_at_range
- (object): Date range for when jobs were posted by the person's current employermin
- (string): Earliest date when jobs were posted by the person's current employer (YYYY-MM-DD)max
- (string): Latest date when jobs were posted by the person's current employer (YYYY-MM-DD)page
- (integer): Page number for pagination (default: 1)per_page
- (integer): Number of results per page (max: 100, default: 25)
Discover companies matching specific criteria with comprehensive filtering options.
Parameters:
- q_organization_domains_list (array): List of organization domains to search fororganization_locations
- (array): The location of the company headquarters (e.g., 'texas', 'tokyo', 'spain')organization_not_locations
- (array): Exclude companies from search results based on location (e.g., 'minnesota', 'ireland', 'seoul')organization_num_employees_ranges
- (array): Employee count ranges with upper and lower numbers separated by comma (e.g., '1,10', '250,500', '10000,20000')revenue_range
- (object): Search for organizations based on their revenue rangemin
- (integer): Minimum revenue amount (no currency symbols, commas, or decimals)max
- (integer): Maximum revenue amount (no currency symbols, commas, or decimals)currently_using_any_of_technology_uids
- (array): Technologies the organization currently uses (use underscores for spaces, e.g., 'salesforce', 'google_analytics', 'wordpress_org')q_organization_keyword_tags
- (array): Filter search results based on keywords associated with companies (e.g., 'mining', 'sales strategy', 'consulting')q_organization_name
- (string): Filter search results to include a specific company name (partial matches accepted)organization_ids
- (array): Apollo IDs for specific companies to include in search resultslatest_funding_amount_range
- (object): Funding amount range for the company's most recent funding roundmin
- (integer): Minimum amount from most recent funding round (no currency symbols, commas, or decimals)max
- (integer): Maximum amount from most recent funding round (no currency symbols, commas, or decimals)total_funding_range
- (object): Total funding amount range across all funding roundsmin
- (integer): Minimum total funding amount across all rounds (no currency symbols, commas, or decimals)max
- (integer): Maximum total funding amount across all rounds (no currency symbols, commas, or decimals)latest_funding_date_range
- (object): Date range for when the company received its most recent funding roundmin
- (string): Earliest date of most recent funding round (YYYY-MM-DD)max
- (string): Latest date of most recent funding round (YYYY-MM-DD)q_organization_job_titles
- (array): Job titles listed in active job postings at the company (e.g., 'sales manager', 'research analyst')organization_job_locations
- (array): Locations of jobs being actively recruited by the company (e.g., 'atlanta', 'japan')organization_num_jobs_range
- (object): Range for number of job postings active at the companymin
- (integer): Minimum number of active job postings at the companymax
- (integer): Maximum number of active job postings at the companyorganization_job_posted_at_range
- (object): Date range for when jobs were posted by the companymin
- (string): Earliest date when jobs were posted by the company (YYYY-MM-DD)max
- (string): Latest date when jobs were posted by the company (YYYY-MM-DD)page
- (integer): Page number for pagination (default: 1)per_page
- (integer): Number of results per page (max: 100, default: 25)
Access job postings for specific organizations.
Parameters:
- organization_id (string, required): Apollo.io organization ID
Get email address for a person using their Apollo ID.
Parameters:
- apollo_id (string, required): Apollo.io person ID
Find employees of a company using company name or website/LinkedIn URL.
Parameters:
- company (string, required): Company namewebsite_url
- (string): Company website URLlinkedin_url` (string): Company LinkedIn URL
-
MIT License - see LICENSE file for details.