apollo-io

This MCP server provides a Node.js implementation that integrates Apollo.io data into MCP-enabled AI workflows. It exposes tools that let you enrich people and organizations, search for people and organizations, and retrieve job postings for specific organizations via Apollo.io. The server is designed to be used with MCP-compatible AI assistants, allowing you to issue structured tool calls that correspond to Apollo.io actions such as people_enrichment, organization_enrichment, people_search, organization_search, and organization_job_postings. To authenticate, you supply an Apollo.io API key either as an environment variable or as a CLI argument when starting the server. Once running, you can connect your AI assistant to the MCP endpoint and begin issuing tool invocations to query Apollo.io data in real time.

Prerequisites:

• Node.js (LTS version) and npm installed on your machine
• Git installed

Steps:

1. Clone the repository

   git clone https://github.com/lkm1developer/apollo-io-mcp-server.git
   cd apollo-io-mcp-server
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

4. Create an Apollo.io API key (in Apollo.io account settings) and set it via environment variable or CLI
   • Environment variable (preferred):

     export APOLLO_IO_API_KEY=your-api-key
     

   • CLI argument (when starting):

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

5. Start the server

   npm start
   

6. Optional: Run the SSE server with authentication if you need a separate authenticated SSE endpoint

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

Environment variable tips:

• APOLLO_IO_API_KEY is required for authenticating requests against Apollo.io.
• You can also pass the API key via the CLI using --api-key (e.g., npm start -- --api-key=your-api-key). SSE Authentication:
• If you enable the SSE server with mcp-proxy-auth, ensure AUTH_SERVER_URL points to your key verification endpoint.
• The SSE URL will be available at localhost:8080/sse?apiKey=apikey (replace apikey with your actual key). Common issues:
• Invalid or missing API key leads to authentication errors from Apollo.io.
• Build errors after npm run build usually indicate TypeScript compilation issues; ensure dependencies are installed and environment is compatible with Node.js version. Configuration options:
• You can extend or modify tools by updating src/apollo-client.ts and src/index.ts before rebuilding.