Hunter MCP — Claude Code MCP server: features and setup
Search for professional email addresses, check their validity, and enrich people or company records with Hunter. Useful for domain research and lead workflows.
claude mcp add --env HUNTER_API_KEY=<HUNTER_API_KEY> --env HUNTER_API_BASE=<HUNTER_API_BASE> --env HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS> --env HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS> --transport stdio hunter-mcp -- npx -y @scalably-io/hunter-mcpWhat Hunter MCP does
Hunter MCP exposes 11 tools for domain email searches, address lookup and verification, email counts, person and company enrichment, company discovery, and lead management. You can also inspect account plan details and credit balances.
Set HUNTER_API_KEY to a Hunter API key, then run @scalably-io/hunter-mcp with npx. Most tools only read data. create_lead adds a record to a Hunter leads list and makes a single mutation attempt, so check the address and lead details before calling it.
What it helps with
- find employee addresses associated with a company domain
- verify an email before adding it to a list
- enrich a person or company profile
- discover companies using search filters
- review Hunter leads and credit balances
Example prompts for the agent
- Find professional addresses for people at
example.com. - Check whether
[email protected]is deliverable. - Create a Hunter lead for
[email protected].
How to install Hunter MCP
Platform CLI
claude mcp add --env HUNTER_API_KEY=<HUNTER_API_KEY> --env HUNTER_API_BASE=<HUNTER_API_BASE> --env HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS> --env HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS> --transport stdio hunter-mcp -- npx -y @scalably-io/hunter-mcpReplace <…> with your own values
Platform CLI
codex mcp add hunter-mcp --env HUNTER_API_KEY=<HUNTER_API_KEY> --env HUNTER_API_BASE=<HUNTER_API_BASE> --env HUNTER_TIMEOUT_MS=<HUNTER_TIMEOUT_MS> --env HUNTER_RETRY_BASE_MS=<HUNTER_RETRY_BASE_MS> -- npx -y @scalably-io/hunter-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"hunter-mcp": {
"command": "npx",
"args": [
"-y",
"@scalably-io/hunter-mcp"
],
"env": {
"HUNTER_API_KEY": "<HUNTER_API_KEY>",
"HUNTER_API_BASE": "<HUNTER_API_BASE>",
"HUNTER_TIMEOUT_MS": "<HUNTER_TIMEOUT_MS>",
"HUNTER_RETRY_BASE_MS": "<HUNTER_RETRY_BASE_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"hunter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@scalably-io/hunter-mcp"
],
"env": {
"HUNTER_API_KEY": "<HUNTER_API_KEY>",
"HUNTER_API_BASE": "<HUNTER_API_BASE>",
"HUNTER_TIMEOUT_MS": "<HUNTER_TIMEOUT_MS>",
"HUNTER_RETRY_BASE_MS": "<HUNTER_RETRY_BASE_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HUNTER_API_KEY=<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> hunter-mcp npx -y @scalably-io/hunter-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Hunter MCP
How do I install Hunter MCP in Claude Code?
Replace the placeholder with your Hunter API key, then run claude mcp add hunter-mcp -e HUNTER_API_KEY=<HUNTER_API_KEY> -- npx -y @scalably-io/hunter-mcp.
What does Hunter MCP do?
It gives an AI client Hunter tools for finding and checking email addresses, enriching records, discovering companies, and managing leads.
Which Hunter MCP tool changes data?
create_lead writes a lead to a Hunter list in a single mutation attempt. The other tools are read-only.
