Apollo.io MCP Server Ndg

🚀 Apollo.io MCP Server

This project offers an MCP server that exposes the functionality of the Apollo.io API as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).

🚀 Quick Start

To use this MCP server, you need to follow these steps:

1. Set the APOLLO_IO_API_KEY environment variable to your Apollo.io API key. Alternatively, create a .env file in the project root directory and add APOLLO_IO_API_KEY.
2. Install the dependencies: uv sync
3. Run the command: uv run mcp run server.py

✨ Features

The following features are exposed as MCP tools:

• people_enrichment: Enrich data for 1 person using the people enrichment endpoint.
• organization_enrichment: Enrich data for 1 company using the organization enrichment endpoint.
• people_search: Find people using the people search endpoint.
• organization_search: Find organizations using the organization search endpoint.
• organization_job_postings: Find job postings for a specific organization using the organization job postings endpoint.

📚 Documentation

Overview

This project mainly consists of the following key components:

• apollo_client.py: Defines the ApolloClient class for interacting with the Apollo.io API. It includes methods such as people enrichment, organization enrichment, people search, organization search, and organization job postings.
• server.py: Defines a FastMCP server that exposes the Apollo.io API functionality as tools. It uses the ApolloClient class defined in apollo_client.py to interact with the API.
• apollo/: Contains the data models for the Apollo.io API, such as PeopleEnrichmentQuery, OrganizationEnrichmentQuery, PeopleSearchQuery, OrganizationSearchQuery, and OrganizationJobPostingsQuery.

Data Model

The apollo/ directory contains the data models for the Apollo.io API. These models are used to define the input and output of the MCP tools.

• apollo/people.py: Defines the data model for the people enrichment endpoint.
• apollo/organization.py: Defines the data model for the organization enrichment endpoint.
• apollo/people_search.py: Defines the data model for the people search endpoint.
• apollo/organization_search.py: Defines the data model for the organization search endpoint.
• apollo/organization_job_postings.py: Defines the data model for the organization job postings endpoint.

Testing

To test, set the APOLLO_IO_API_KEY environment variable and then run uv run apollo_client.py.

Using with Claude for Desktop

1. Configure Claude for Desktop to use these MCP servers by adding them to your claude_desktop_config.json file:

{
  "mcpServers": {
    "apollo-io-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "path/to/apollo-io-mcp-server/server.py"
      ]
    }
  }
}

📦 Resources

• Apollo.io API Documentation
• MCP Protocol Documentation
• Claude for Desktop Documentation