# Hunter MCP

Search for professional email addresses, check their validity, and enrich people or company records with Hunter. Useful for domain research and lead workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: scalably-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/scalably-io/hunter-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/hunter-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HUNTER_API_KEY`, `HUNTER_API_BASE`, `HUNTER_TIMEOUT_MS`, `HUNTER_RETRY_BASE_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Find professional addresses for people at `example.com`.
- Check whether `person@example.com` is deliverable.
- Create a Hunter lead for `person@example.com`.

## Similar
- [hunter](https://affpapa.org/en/nevibecode/plugins/hunter.md) — plugin · ★ 8
- [contact-hunter](https://affpapa.org/en/nevibecode/skills/contact-hunter.md) — skill · 436 installs
- [ZoomInfo](https://affpapa.org/en/nevibecode/mcp/zoominfo.md) — MCP server · ★ 9
- [Leadbase | AI B2B Lead Generation](https://affpapa.org/en/nevibecode/mcp/leadbase-ai-b2b-lead-generation.md) — MCP server · ★ 1
- [cargo-gtm](https://affpapa.org/en/nevibecode/skills/cargo-gtm.md) — skill · 10000 installs
- [Tomba MCP Server](https://affpapa.org/en/nevibecode/mcp/tomba-mcp-server.md) — MCP server · ★ 8

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md