# Apollo MCP Server

An [MCP](https://modelcontextprotocol.io/) server for the [Apollo.io](https://www.apollo.io/) API. Provides tools for people search, company search, enrichment, job postings, and news articles.

## Features

- **People search** with filters for titles, seniority, locations, companies, industries, technologies, and more
- **Company search** with filters for size, location, revenue, funding, keywords, and tech stack
- **Person enrichment** by email, LinkedIn URL, name + company, or Apollo ID
- **Company enrichment** by domain or name
- **Bulk enrichment** for people and organizations
- **Job postings** and full organization info by Apollo ID
- **News article search** related to companies

## Setup

```bash
git clone https://github.com/YOUR_USERNAME/apollo-mcp.git
cd apollo-mcp
npm install
cp .env.example .env
# Edit .env and add your Apollo API key
```

## Usage with Claude Desktop

Add this to your Claude Desktop config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "apollo": {
      "command": "node",
      "args": ["/absolute/path/to/apollo-mcp/src/server.js"],
      "env": {
        "APOLLO_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

Replace `/absolute/path/to/apollo-mcp/` with the actual path where you cloned the repo.

Then restart Claude Desktop to pick up the new server.

## Testing

```bash
npm start
```

The server should print `Apollo MCP server running` to stderr and wait for MCP messages on stdin.

## Tools

| Tool | Description |
|------|-------------|
| `apollo_search_people` | Search people with advanced filters |
| `apollo_search_companies` | Search companies with advanced filters |
| `apollo_enrich_person` | Enrich a person by email, LinkedIn, name+company, or Apollo ID |
| `apollo_enrich_company` | Enrich a company by domain or name |
| `apollo_bulk_enrich_people` | Bulk enrich multiple people |
| `apollo_bulk_enrich_organizations` | Bulk enrich multiple organizations |
| `apollo_get_organization_job_postings` | Get job postings for an organization |
| `apollo_get_complete_organization_info` | Get full organization details |
| `apollo_search_news_articles` | Search company-related news articles |

## License

MIT