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.

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/lkm1developer/apollo-io-mcp-server.git
cd apollo-io-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

The server requires an Apollo.io API access token. You can obtain one by:

1. Going to your Apollo.io Account
2. Navigating to Settings > API
3. Generating an API key

You can provide the token in two ways:

1. As an environment variable:

   APOLLO_IO_API_KEY=your-api-key
   

2. As a command-line argument:

   npm start -- --api-key=your-api-key
   

For development, create a .env file in the project root to store your environment variables:

APOLLO_IO_API_KEY=your-api-key

Usage

Starting the Server

# Start the server
npm start

# Or with a specific API key
npm start -- --api-key=your-api-key

# Run the SSE server with authentication
npx mcp-proxy-auth node dist/index.js

Implementing Authentication in SSE Server

The SSE server uses the mcp-proxy-auth package for authentication. To implement authentication:

1. Install the package:

   npm install mcp-proxy-auth
   

2. Set the AUTH_SERVER_URL environment variable to point to your API key verification endpoint:

   export AUTH_SERVER_URL=https://your-auth-server.com/verify
   

3. Run the SSE server with authentication:

   npx mcp-proxy-auth node dist/index.js
   

4. The SSE URL will be available at:

   localhost:8080/sse?apiKey=apikey
   

   Replace apikey with your actual API key for authentication.

The mcp-proxy-auth package acts as a proxy that:

• Intercepts requests to your SSE server
• Verifies API keys against your authentication server
• Only allows authenticated requests to reach your SSE endpoint

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
   • P

... View full README on GitHub