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+

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:

cp .env.example .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 (free account, no card)
• Apollo.io → Settings → Integrations → API Keys at app.apollo.io

---

Claude Desktop

Edit claude_desktop_config.json — on Windows at %APPDATA%\Claude\claude_desktop_config.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:

{
  "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.

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 — available for custom MCP and AI automation work.
Contact: @Aleksey_Ai14