Apollo IO MCP Server
A Model Context Protocol (MCP) server implementation for seamless integration with the Apollo.io API, enabling AI assistants to interact with Apollo.io data for enriching information about people and organizations.
Apollo.io MCP Server
A 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.
Features
- 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
Installation
npm install @agentx-ai/apollo-io-mcp-server
Test locally
npm install -g .
npx @modelcontextprotocol/inspector apollo-io-mcp-server
Then add APOLLO_IO_API_KEY in Environment Variable
Available Tools
1. People Enrichment (people_enrichment)
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
2. Organization Enrichment (organization_enrichment)
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')
3. People Search (people_search)
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 employer
organization_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)
4. Organization Search (organization_search)
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 company
organization_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)
5. Organization Job Postings (organization_job_postings)
Access job postings for specific organizations.
Parameters:
organization_id(string, required): Apollo.io organization ID
6. Get Person Email (get_person_email)
Get email address for a person using their Apollo ID.
Parameters:
apollo_id(string, required): Apollo.io person ID
7. Employees of Company (employees_of_company)
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
License
MIT License - see LICENSE file for details.
