mcp-apollo

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.

Parameter	Type	Description
person_titles	string[]	Job titles, e.g. ["VP Engineering", "CTO"]
person_seniorities	string[]	"vp", "c_suite", "director", "manager", "senior"
organization_domains	string[]	Company domains, e.g. ["stripe.com"]
person_locations	string[]	Locations, e.g. ["New York", "San Francisco"]
organization_num_employees_ranges	string[]	Size ranges, e.g. ["51,200", "201,500"]
page	number	Page number (default: 1)
per_page	number	Results per page, max 25 (default: 10)

---

apollo_enrich_person

Get a full enriched profile for a specific person.

Parameter	Type	Description
email	string	Most reliable identifier
linkedin_url	string	LinkedIn profile URL
first_name + last_name + organization_name	string	Name + company combo

At least one identifier is required.

---

apollo_search_companies

Search for companies matching criteria.

Parameter	Type	Description
q_organization_keyword_tags	string[]	Keywords/industries, e.g. ["SaaS", "fintech"]
organization_locations	string[]	HQ locations
organization_num_employees_ranges	string[]	Size ranges
organization_funding_stages	string[]	"Seed", "Series A", "Series B" etc.
page	number	Page (default: 1)
per_page	number	Max 25 (default: 10)

---

apollo_enrich_company

Get a full company profile by domain or name.

Parameter	Type	Description
domain	string	e.g. "stripe.com" — preferred
name	string	Company name — fallback

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.

Parameter	Type	Description
organization_id	string	Apollo org ID from apollo_enrich_company
job_titles	string[]	Optional filter, e.g. ["engineer", "sales"]

---

apollo_find_email

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

Parameter	Type	Description
person_id	string	Apollo person ID from apollo_search_people

---

Apollo.io rate limits

Plan	Requests / hour
Free	50
Basic	200
Professional	1,000
Organization	Custom

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

Metric	Free limit
Requests	100,000 / day
CPU time	10ms / request

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:

Secret	Where to get it
CLOUDFLARE_API_TOKEN	Cloudflare Dashboard → My Profile → API Tokens → Create Token (use "Edit Cloudflare Workers" template)
CLOUDFLARE_ACCOUNT_ID	Cloudflare Dashboard → Workers & Pages → right sidebar

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