Content
# 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.**
---
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)
