Apollo.io MCP Server
This project provides an MCP server that exposes the Apollo.io API functionalities as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).
Overview
The project consists of the following main components:
apollo_client.py: Defines theApolloClientclass, which is used to interact with the Apollo.io API. It includes methods for people enrichment, organization enrichment, people search, organization search, and organization job postings.server.py: Defines the FastMCP server, which exposes the Apollo.io API functionalities as tools. It uses theApolloClientclass defined inapollo_client.pyto interact with the API.apollo/: Contains the data models for the Apollo.io API, such asPeopleEnrichmentQuery,OrganizationEnrichmentQuery,PeopleSearchQuery,OrganizationSearchQuery, andOrganizationJobPostingsQuery.
Functionalities
The following functionalities are exposed as MCP tools:
people_enrichment: Use the People Enrichment endpoint to enrich data for 1 person.organization_enrichment: Use the Organization Enrichment endpoint to enrich data for 1 company.people_search: Use the People Search endpoint to find people.organization_search: Use the Organization Search endpoint to find organizations.organization_job_postings: Use the Organization Job Postings endpoint to find job postings for a specific organization.
Usage
To use this MCP server, you need to:
- Set the
APOLLO_IO_API_KEYenvironment variable with your Apollo.io API key. Or create '.env' file in the project root withAPOLLO_IO_API_KEY. - Get dependencies:
uv sync - Run the
uv run mcp run server.py
Data Models
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 models for the People Enrichment endpoint.apollo/organization.py: Defines the data models for the Organization Enrichment endpoint.apollo/people_search.py: Defines the data models for the People Search endpoint.apollo/organization_search.py: Defines the data models for the Organization Search endpoint.apollo/organization_job_postings.py: Defines the data models for the Organization Job Postings endpoint.
Testing
To test, set APOLLO_IO_API_KEY environment variable and run uv run apollo_client.py.
Usage with Claude for Desktop
- Configure Claude for Desktop to use these MCP servers by adding them to your
claude_desktop_config.jsonfile:
{
"mcpServers": {
"apollo-io-mcp-server": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"mcp",
"run",
"path/to/apollo-io-mcp-server/server.py"
]
}
}
}
Resources
Metadata
Release files for iflow-mcp_edwardchoh-apollo-io-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0.tar.gz | 12.3 kB | Without provenance | Details for iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 28.4 kB
Release files / iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 12.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ac5b6e0869d4db2a89181132d21f139e09c10a6896ae5e60b7a4d76d97d44ba7
|
|
BLAKE2b-256 checksum How to use checksums |
d010c965c1d988019097b8a0491f1dcc979e50ccf6a1567b4fb7c9108fc06635
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_edwardchoh_apollo_io_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
daaf96197862c93d27e3cb00d0d1b69f443c6be17c121296147f2f935f585513
|
|
BLAKE2b-256 checksum How to use checksums |
c9bdff22dd55c2ea17680288db4cc50c8296860d372cf4accdbbbd11fe85be7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_edwardchoh-apollo-io-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.