b2b-enrichment-mcp
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_peopleandsearch_companiesare also included but require an Apollo Basic plan ($49/mo).
Related MCP server: @louis030195/apollo-io-mcp
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_hereGet 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-featureLicense
MIT
Built by @Aleksey-Panf β available for custom MCP and AI automation work.
Contact: @Aleksey_Ai14
Available Tools
11 toolsbulk_enrich_peopleA
[Apollo] Enrich up to 10 people in a single API call.
Best for: enriching a batch of contacts at once β faster than looping over enrich_person and uses the same total credits (1 per matched person). Works on free Apollo plan.
Inputs: people (required), reveal_personal_emails.
enrich_companyA
[Apollo] Enrich a company's full firmographic profile by domain.
Best for: company intelligence that Hunter doesn't provide β headcount, revenue range, funding stage, investors, tech stack, industry, and social links. Use this alongside Hunter email tools for a complete company + contacts picture. Costs 1 Apollo credit. Works on free Apollo plan. Returns: legal name, employee count, revenue range, industry, founding year, funding stage and total raised, tech stack, LinkedIn, Twitter, website. Examples: stripe.com, openai.com, notion.so, figma.com
Inputs: domain (required).
enrich_personA
[Apollo] Enrich a person's B2B profile by name and at least one identifier.
Best for: enriching a contact when you have name + employer but no email yet (consider using hunter_find_email first β it may be cheaper). Costs 1 Apollo credit normally; 8 credits with reveal_phone_number=True. Provide at least one of: domain, organization_name, email, or linkedin_url.
Inputs: last_name (required), first_name (required), email, domain, +4 more.
enrich_person_by_emailA
[Apollo] Enrich a person's full B2B profile using only their email address.
Best for: the most common lead-gen workflow β you have an email (e.g. from Hunter) and want the full profile: job title, seniority, LinkedIn, company, and phone. Fastest and most reliable Apollo enrichment path. Costs 1 Apollo credit. Works on free Apollo plan.
Inputs: email (required), reveal_personal_emails.
hunter_check_accountA
[Hunter] Return Hunter.io account info including remaining credits.
Best for: checking how many finder and verifier credits remain before running a large enrichment batch. FREE β does not consume any credits. Returns plan name, monthly quota, requests used, and credits remaining.
Inputs: no named parameters.
hunter_count_emailsA
[Hunter] Count how many email addresses Hunter has indexed for a domain.
Best for: quickly checking data availability before spending credits on a full domain search. Run this first when exploring a new target company. FREE β does not consume any credits or quota. Returns total email count broken down by department and seniority.
Inputs: domain (required).
hunter_find_emailA
[Hunter] Find the most likely work email address for a specific person.
Best for: finding a contact email when you know the person's name and employer. Costs 1 Hunter finder credit. Returns the guessed email with a confidence score (0β100), sources, and verification status. A score above 70 is generally reliable for outreach.
Inputs: domain (required), last_name (required), first_name (required).
hunter_find_emails_by_domainA
[Hunter] Find all email addresses associated with a company domain.
Best for: prospecting a whole company, building outreach lists, discovering team structure at a target account. Costs 1 Hunter request (monthly quota). Does NOT consume per-email credits. Returns emails with confidence scores, names, job titles, and LinkedIn URLs. Use hunter_count_emails first to gauge data availability for free.
Inputs: domain (required), limit, department, email_type.
hunter_verify_emailA
[Hunter] Verify the deliverability of an email address.
Best for: cleaning a lead list before sending outreach, validating emails found by other tools, reducing bounce rates. Costs 1 Hunter verification credit. Returns status: 'valid' | 'invalid' | 'accept_all' | 'webmail' | 'unknown', plus SMTP and MX record check details. Only send to 'valid' addresses.
Inputs: email (required).
search_companiesA
[Apollo] Search Apollo's company database by keyword, location, or headcount.
REQUIRES Apollo Basic plan ($49/mo) or higher β returns HTTP 403 on the free tier. Does NOT consume credits. Does NOT return email addresses. To get contacts from results, use hunter_find_emails_by_domain (Hunter) or enrich_company (Apollo) for firmographic details (1 credit each).
Inputs: page, keywords, locations, employee_ranges.
search_peopleA
[Apollo] Search Apollo's people database by title, location, or seniority.
REQUIRES Apollo Basic plan ($49/mo) or higher β returns HTTP 403 on the free tier. Does NOT consume credits. Does NOT return email addresses. To get emails for results, use hunter_find_email or enrich_person (1 credit each).
Inputs: page, person_titles, employee_ranges, person_locations, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose: Apollo tools handle company/person enrichment in different ways, Hunter tools cover email finding, verification, and account info, and search tools are for prospecting. Even similar tools like enrich_person and enrich_person_by_email are differentiated by required inputs.
All tool names follow a consistent verb_noun pattern with underscores, e.g., enrich_company, hunter_find_email, search_people. This makes the API predictable and easy to navigate.
11 tools is a well-scoped number for a B2B enrichment server. It covers essential operations from both Apollo and Hunter without being excessive or leaving gaps.
The tool set provides full coverage for B2B enrichment workflows: company and person enrichment, email finding and verification, batch operations, and search. No obvious missing operations like update/delete are needed for this domain.
Maintenance
Related MCP Connectors
Remote MCP server to enrich company profiles with structured B2B data and confidence scores.
Apollo.io MCP β company and people data via api.apollo.io, the caller's OWN Apollo account (fleetβ¦
Your agent needs B2B contacts and the pipeline objects around them β find the company, find the person, get the email, then write it back where your team works. **What you can ask for** β’ "Find heads of engineering at Series-B SaaS companies in the Nordics, with emails." β’ "Enrich these companies with headcount, industry and funding." β’ "What roles is this company hiring for right now?" β’ "Create an account and a contact, then log this opportunity." β’ "Search our sequences for messages sent to this domain." **How to use it** Point any MCP client at https://mcp.aisa.one/apollo/mcp and sign in with OAuth β there is no key to create or paste. 54 tools: people and organisation search and enrichment, job postings, accounts, contacts, opportunities and their stages, custom fields, labels, notes, users, email accounts, sequence messages and phone-call search β reads and writes. **Why this rather than the source** The full object model, not just a search endpoint, so an agent can finish the job rather than hand you a CSV. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the person here, then ask the same agent what their company's traffic looks like or what they rank for β without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp adds Similarweb and creator discovery around it.
Hunter.io MCP β wraps the Hunter.io email finder & verification API (hunter.io)
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server for Apollo.io B2B database enabling people and company search, enrichment, and insights through conversational interfaces.99,302 npm19MIT
- AlicenseAqualityDmaintenanceMCP server for Apollo.io B2B sales intelligence API. Enables searching and enriching people and organizations via natural language.722 npm4MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the Apollo.io API that lets LLMs search and enrich people and company data.78 npmMIT
- AlicenseAqualityDmaintenanceLead generation MCP server for AI agents. Find emails, verify contacts, enrich profiles, and search prospects using Hunter.io, Apollo.io, and Abstract API.819 npmMIT