mcp-apollo

An open-source, self-hosted MCP server for Apollo.io — gives your AI agents direct access to Apollo's B2B sales intelligence database.

Deploy it to your own Cloudflare account in under 5 minutes. You own the infrastructure, you control the costs. No shared hosting, no vendor lock-in.

Built and maintained by AgenTeam. MIT licensed.

How it works

Your Cloudflare Workers account
  └── mcp-apollo Worker  (your deploy, your infra)
        └── MCP client sends requests with your Apollo API key
              └── Worker proxies to Apollo.io API
                    └── Returns enriched data to your agent

• You deploy the Worker to your own Cloudflare account (free tier handles most use cases)
• You pass your own Apollo.io API key on every request — the Worker never stores it
• No shared infrastructure — every user runs their own isolated instance

Quick deploy (5 minutes)

Prerequisites

• Node.js 18+
• A Cloudflare account (free tier is sufficient)
• An Apollo.io API key

Steps

# 1. Clone the repo
git clone https://github.com/AgenTeam-AI-2026/mcp-apollo
cd mcp-apollo

# 2. Install dependencies
npm install

# 3. Log in to your Cloudflare account
npx wrangler login

# 4. Deploy
npx wrangler deploy

Your server is now live at:

https://mcp-apollo.<your-subdomain>.workers.dev

That's your personal MCP server URL. Use it in the connection configs below.

Connect your MCP client

Replace YOUR_WORKER_URL with your deployed URL and YOUR_APOLLO_KEY with your Apollo.io API key.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_WORKER_URL/mcp"],
      "env": {
        "APOLLO_API_KEY": "YOUR_APOLLO_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add apollo \
  --transport http \
  --url https://YOUR_WORKER_URL/mcp \
  --header "Authorization: Bearer YOUR_APOLLO_KEY"

Cursor

In .cursor/mcp.json:

{
  "mcpServers": {
    "apollo": {
      "url": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

Windsurf

In ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apollo": {
      "serverUrl": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

Get an Apollo.io API key

1. Log in to apollo.io
2. Go to Settings → Integrations → API
3. Click Create API Key
4. Copy the key — paste it into your MCP client config above

Tools

apollo_search_people

Search Apollo's database for people matching filters.

apollo_enrich_person

Get a full enriched profile for a specific person.

At least one identifier is required.

apollo_search_companies

Search for companies matching criteria.

apollo_enrich_company

Get a full company profile by domain or name.

Returns: description, headcount, founding year, total funding, funding stage, tech stack, keywords.

apollo_get_job_postings

Get active job postings for a company — a strong buying/hiring signal.

apollo_find_email

Retrieve a person's verified email by their Apollo person ID.

Apollo.io rate limits

The server returns rate limit metadata with every response (rate_limits.remaining, rate_limits.resetAt). On 429 errors it returns an informative message — it never silently fails.

Cloudflare Workers free tier

100k requests/day is enough for most individual or small-team deployments. If you exceed it, upgrade to the Workers Paid plan ($5/month for 10M requests).

Local development

npm install
npm run dev
# Server runs at http://localhost:8787

Run tests

npm test                                        # unit + RALPH-loop tests
APOLLO_API_KEY=your_key npx vitest run test/e2e # E2E against live Apollo API

CI/CD on your fork

The repo includes GitHub Actions workflows:

• ci.yml — runs typecheck, build check, and tests on every push
• deploy.yml — deploys to Cloudflare Workers on merge to main
• e2e.yml — nightly E2E tests against the live Apollo API

To enable auto-deploy, add these secrets in your fork under GitHub → Settings → Secrets → Actions:

To enable nightly E2E tests, also add APOLLO_API_KEY as a secret and set the repo variable APOLLO_E2E_ENABLED to true.

Security

• Your Apollo API key is passed as a Bearer token in the Authorization header on each request
• The Worker never stores, logs, or persists your API key
• Each request is stateless — the key is used only for that request's Apollo API call
• You control the entire deployment — no data touches third-party infrastructure

Built by AgenTeam

AgenTeam builds AI agent teams for B2B sales and GTM operations. mcp-apollo is one of several open-source MCP servers we publish to give agents direct access to the tools modern sales teams rely on.

License

MIT © AgenTeam-AI-2026