Apollo.io MCP Server using Docker for MCPO

A powerful Model Context Protocol (MCP) server implementation for seamless Apollo.io API integration, enabling AI assistants to interact with Apollo.io data.

Overview

This MCP server provides a comprehensive set of tools for interacting with the Apollo.io API, allowing AI assistants to:

• Enrich data for people and organizations
• Search for people and organizations
• Find job postings for specific organizations
• Perform Apollo.io operations without leaving your AI assistant interface

Why Use This MCP Server?

• Seamless AI Integration: Connect your AI assistants directly to Apollo.io data
• Simplified API Operations: Perform common Apollo.io tasks through natural language commands
• Real-time Data Access: Get up-to-date information from Apollo.io
• Secure Authentication: Uses Apollo.io's secure API token authentication
• Extensible Design: Easily add more Apollo.io API capabilities as needed

Installation

# Clone the repository
git clone https://github.com/rollingstone87/apollo-mcpo.git
cd apollo-mcpo

# Build Image from the repo
docker built -t apollo-mcp .

Usage

Starting the Server with MCPO

STEP 1. Prepare your config file for mcpo

{
  "mcpServers": {
    "apollo-mcpo-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network", "mcp-network",
        "-e", "APOLLO_IO_API_KEY=your_api_key",
        "apollo-mcp-image"
      ]      
    }
  }
}

Step 2. Start the Container in Docker

# Start the server
docker run -d --name mcpo-docker-tools -p 8001:8000 --network mcp-network -v /path/to/config-docker-apollo.json:/app/config-docker-apollo.json -v /var/run/docker.sock:/var/run/docker.sock -e APOLLO_IO_API_KEY="your_api_key" mcpo-docker:latest mcpo --config /app/config-docker-apollo.json

Integrating with AI Assistants

This MCP server is designed to work with AI assistants that support the Model Context Protocol. Once running, the server exposes a set of tools that can be used by compatible AI assistants to interact with Apollo.io data.

Available Tools

The server exposes the following powerful Apollo.io integration tools:

1. people_enrichment

   • Use the People Enrichment endpoint to enrich data for 1 person
   • Parameters:
     • first_name (string, optional): Person's first name
     • last_name (string, optional): Person's last name
     • email (string, optional): Person's email address
     • domain (string, optional): Company domain
     • organization_name (string, optional): Organization name
   • Example:

     {
       "first_name": "John",
       "last_name": "Doe",
       "email": "john.doe@example.com"
     }

2. organization_enrichment

   • Use the Organization Enrichment endpoint to enrich data for 1 company
   • Parameters:
     • domain (string, optional): Company domain
     • name (string, optional): Company name
   • Example:

     {
       "domain": "apollo.io"
     }

3. people_search

   • Use the People Search endpoint to find people
   • Parameters:
     • q_organization_domains_list (array, optional): List of organization domains to search within
     • person_titles (array, optional): List of job titles to search for
     • person_seniorities (array, optional): List of seniority levels to search for
   • Example:

     {
       "person_titles": ["Marketing Manager"],
       "person_seniorities": ["vp"],
       "q_organization_domains_list": ["apollo.io"]
     }

4. organization_search

   • Use the Organization Search endpoint to find organizations
   • Parameters:
     • q_organization_domains_list (array, optional): List of organization domains to search for
     • organization_locations (array, optional): List of organization locations to search for
   • Example:

     {
       "organization_locations": ["Japan", "Ireland"]
     }

5. organization_job_postings

   • Use the Organization Job Postings endpoint to find job postings for a specific organization
   • Parameters:
     • organization_id (string, required): Apollo.io organization ID
   • Example:

     {
       "organization_id": "5e60b6381c85b4008c83"
     }

Extending the Server

The server is designed to be easily extensible. To add new Apollo.io API capabilities:

1. Add new methods to the ApolloClient class in src/apollo-client.ts
2. Register new tools in the setupToolHandlers method in src/index.ts
3. Rebuild the project with npm run build

License

This project is licensed under the MIT License - see the LICENSE file for details.

Keywords

Apollo.io, Model Context Protocol, MCP, AI Assistant, TypeScript, API Integration, Apollo.io API, People Enrichment, Organization Enrichment, People Search, Organization Search, Job Postings, AI Tools