# B2B Enrichment MCP
[![Glama score](https://glama.ai/mcp/servers/Aleksey-Panf/b2b-enrichment-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Aleksey-Panf/b2b-enrichment-mcp)

**Unified MCP server combining Hunter.io email finding with Apollo company intelligence. One connection, two data sources, built for Claude and Cursor.**

![demo](demo.png)

---

Lead generation workflows need two things: email addresses and company context. Most MCP servers handle one or the other. This one handles both — Hunter.io for finding and verifying emails, Apollo.io for firmographic data like headcount, funding, and tech stack. One server, one config, Claude orchestrates across both.

---

## Tools

**Hunter.io — email intelligence**

- 🔍 `hunter_find_emails_by_domain` — get all emails at a company domain with names, titles, and confidence scores
- 🎯 `hunter_find_email` — find the most likely email for a specific person by name + domain
- ✅ `hunter_verify_email` — check whether an email is deliverable before sending
- 📊 `hunter_count_emails` — count indexed emails for a domain (free, no credits)
- 💳 `hunter_check_account` — view remaining Hunter credits (free)

**Apollo.io — company & people intelligence**

- 🏢 `enrich_company` — full firmographic profile: headcount, revenue, funding, tech stack, socials
- 👤 `enrich_person_by_email` — complete B2B profile from a single email address
- 🧑‍🤝‍🧑 `bulk_enrich_people` — enrich up to 10 contacts in one API call
- 🔎 `enrich_person` — profile lookup by name + domain, LinkedIn URL, or email

> `search_people` and `search_companies` are also included but require an Apollo Basic plan ($49/mo).

---

## Free tier friendly

You can run real enrichment workflows without paying anything upfront:

| Service | Free allowance |
|---|---|
| Hunter.io | 50 requests/month + 50 verifications |
| Apollo.io | Company enrichment — unlimited on free plan |

No credit card required to start. Both services have free tiers that cover the most common use cases.

---

## Installation

**Requires Python 3.11+**

```bash
git clone https://github.com/Aleksey-Panf/b2b-enrichment-mcp.git
cd b2b-enrichment-mcp

python -m venv .venv

# Windows
.venv\Scripts\Activate.ps1
# macOS / Linux
source .venv/bin/activate

pip install -e .
```

Copy the env template and add your keys:

```bash
cp .env.example .env
```

```env
# .env
HUNTER_API_KEY=your_hunter_key_here
APOLLO_API_KEY=your_apollo_key_here
```

Get your API keys:
- **Hunter.io** → [hunter.io/api-keys](https://hunter.io/api-keys) (free account, no card)
- **Apollo.io** → Settings → Integrations → API Keys at [app.apollo.io](https://app.apollo.io)

---

## Claude Desktop

Edit `claude_desktop_config.json` — on Windows at `%APPDATA%\Claude\claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "b2b-enrichment": {
      "command": "C:\\path\\to\\b2b-enrichment-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "apollo_mcp.server"],
      "env": {
        "HUNTER_API_KEY": "your_hunter_key_here",
        "APOLLO_API_KEY": "your_apollo_key_here"
      }
    }
  }
}
```

Restart Claude Desktop. The tools will appear automatically.

---

## Cursor

Add to `.cursor/mcp.json` in your project root, or to global Cursor MCP settings:

```json
{
  "mcpServers": {
    "b2b-enrichment": {
      "command": "C:\\path\\to\\b2b-enrichment-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "apollo_mcp.server"],
      "env": {
        "HUNTER_API_KEY": "your_hunter_key_here",
        "APOLLO_API_KEY": "your_apollo_key_here"
      }
    }
  }
}
```

On macOS / Linux replace the `command` path with `.venv/bin/python`.

---

## Example queries

Copy these into Claude or Cursor once the server is connected:

```
Find 10 emails of marketing directors at SaaS companies using Hunter.
```

```
Tell me everything about stripe.com — headcount, funding, tech stack —
and find 5 contacts there.
```

```
Verify whether john@acme.com is a valid email address.
```

```
Get the full company profile for openai.com.
```

```
I have a list of 8 people with names and company domains.
Enrich all of them for emails and job titles in one call.
```

---

## Roadmap

- [ ] LinkedIn URL enrichment via Apollo (resolve profile → full contact)
- [ ] Bulk domain search — run Hunter domain search across a list of domains
- [ ] Export results to CSV directly from Claude
- [ ] Webhook support for async enrichment on large lists

---

## Contributing

PRs are welcome. Open an issue first for anything beyond small fixes.

```bash
git checkout -b feature/your-feature
# make changes
git commit -m "feat: describe your change"
git push origin feature/your-feature
```

---

## License

MIT

---

Built by [@Aleksey-Panf](https://github.com/Aleksey-Panf) — available for custom MCP and AI automation work.  
Contact: [@Aleksey_Ai14](https://t.me/Aleksey_Ai14)