Hunter MCP
Hunter.io MCP: domain search, email finder and verifier, enrichment, discovery, leads. 11 tools.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@scalably-io/hunter-mcpclaude mcp add hunter-mcp -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'HUNTER_API_BASE=<HUNTER_API_BASE>' -e 'HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS>' -e 'HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS>' -- npx -y @scalably-io/hunter-mcp@1.0.0{
"mcpServers": {
"hunter-mcp": {
"command": "npx",
"args": [
"-y",
"@scalably-io/hunter-mcp@1.0.0"
],
"env": {
"HUNTER_API_KEY": "<your hunter_api_key>",
"HUNTER_API_BASE": "<HUNTER_API_BASE>",
"HUNTER_TIMEOUT_MS": "<HUNTER_TIMEOUT_MS>",
"HUNTER_RETRY_BASE_MS": "<HUNTER_RETRY_BASE_MS>"
}
}
}
}Environment variables
HUNTER_API_KEYrequired secret Hunter.io API key from hunter.io/api-keysHUNTER_API_BASEHunter API base URL, default https://api.hunter.io/v2HUNTER_TIMEOUT_MSPer-request timeout in milliseconds, default 30000HUNTER_RETRY_BASE_MSBase delay in milliseconds for the GET retry backoff, default 500
https://github.com/scalably-io/hunter-mcp/releases/download/v1.0.0/hunter-mcp.mcpbDocumentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Hunter MCP
Hunter.io MCP server. 11 tools cover domain search, email finding and verification, enrichment, company discovery, and lead management.
Install
Claude Code:
claude mcp add hunter -e HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcpCodex:
codex mcp add hunter --env HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcpClaude Desktop: download hunter-mcp.mcpb from the latest GitHub release and open it.
Setup
- Create an API key at hunter.io/api-keys.
create_leadwrites to your Hunter leads list and is the only non-read tool; the other 10 tools are read-only.
Tools (11)
| Tool | What it does |
|---|---|
account_info | Read the Hunter v2 account plan and exact current credit usage, including remaining unified or per-type balances |
domain_search | Search Hunter v2 emails for one domain/company with current people, verification, location, job-title, decision-maker, aggregation, and offset filters |
email_finder | Find and automatically verify the most likely professional email from a company/domain plus name, or directly from a LinkedIn handle |
email_verifier | Verify one email address with Hunter v2 and return exact deliverability, score, SMTP/MX, accept-all, webmail, disposable, and source evidence |
email_count | Count Hunter email coverage for a domain/company, optionally limited to personal or generic addresses, without returning addresses |
email_enrichment | Enrich a person from an email address or LinkedIn handle using Hunter v2, optionally in Clearbit-compatible format |
company_enrichment | Enrich a company from its domain using Hunter v2, optionally in Clearbit-compatible format |
combined_enrichment | Enrich both a person and their company from one email using Hunter v2, optionally in Clearbit-compatible format |
discover | Use Hunter Discover v2 to find companies from current natural-language or structured organization, location, industry, headcount, type, year, keyword, technology, and funding filters |
create_lead | Create one Hunter lead from a required email and optional current lead fields, list placement, and custom attributes. This is a single-attempt mutation |
list_leads | List Hunter leads with current list, identity, company, status, verification, activity/date, location, tag, campaign, user, confidence, custom-attribute, query, and offset filters |
Configuration
| Variable | Required | Purpose |
|---|---|---|
HUNTER_API_KEY | yes | Hunter.io API key from hunter.io/api-keys |
HUNTER_API_BASE | no | Override the Hunter API base URL (default https://api.hunter.io/v2) |
HUNTER_TIMEOUT_MS | no | Per-request timeout in milliseconds (default 30000) |
HUNTER_RETRY_BASE_MS | no | Base delay in milliseconds for the GET retry backoff (default 500) |
Reply shape
Every tool returns plain JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures throw a plain error string: <code>: <message> <hint>.
Limits
Hunter's per-plan request quotas surface in account_info.
Verify
Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the packed tarball on every push.
Privacy Policy
This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html
License
MIT. Copyright Scalably.
Frequently asked questions
What is Hunter MCP?
Hunter.io MCP: domain search, email finder and verifier, enrichment, discovery, leads. 11 tools.
How do I install Hunter MCP?
It runs on your machine. In Claude Code: claude mcp add hunter-mcp -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'HUNTER_API_BASE=<HUNTER_API_BASE>' -e 'HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS>' -e 'HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS>' -- npx -y @scalably-io/hunter-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Hunter MCP need an API key?
Yes. It expects HUNTER_API_KEY, which you set in its configuration.
Is Hunter MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Hunter MCP?
It is published by scalably-io. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.