Skip to content

NimbleBrainInc/mcp-hunter

Repository files navigation

Hunter.io MCP Server

mpak NimbleBrain Discord License: MIT

An MCP server that provides access to the Hunter.io API, enabling AI assistants to discover, verify, and enrich email addresses and company data.

View on mpak registry | Built by NimbleBrain

Features

  • Discover companies with AI-powered natural language search or structured filters
  • Search domain emails — find all email addresses for a company
  • Find specific emails by name + domain or LinkedIn handle
  • Verify email deliverability with detailed SMTP checks
  • Enrich person profiles from email or LinkedIn
  • Enrich company data from domain
  • Check account credits and usage

Installation

Using mpak (Recommended)

mpak install @nimblebraininc/hunter

Claude Code

claude mcp add hunter -- mpak run @nimblebraininc/hunter

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hunter": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/hunter"]
    }
  }
}

See the mpak registry page for full install options.

Manual Installation

# Clone the repository
git clone https://github.com/NimbleBrainInc/mcp-hunter.git
cd mcp-hunter

# Install dependencies with uv
uv sync

# Set your API key
export HUNTER_API_KEY=your_api_key_here

# Run the server
uv run python -m mcp_hunter.server

Configuration

Get your API key at hunter.io/api-keys, then configure it:

mpak config set @nimblebraininc/hunter api_key=your_api_key_here

Tools

Tool Description Cost
discover_companies Find companies via AI search or filters Free
search_domain_emails Find all emails for a domain 1 credit / 10 emails
find_email Find a person's email by name+domain 1 credit
verify_email Verify email deliverability 0.5 credits
enrich_person Get person profile from email/LinkedIn 0.2 credits
enrich_company Get company details from domain 0.2 credits
check_account View plan and remaining credits Free

Development

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

# Format code
uv run ruff format src/ tests/

# Lint
uv run ruff check src/ tests/

# Type check
uv run ty check src/

# Run all checks
make check

About

Hunter.io MCP Server is published on the mpak registry and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.

License

MIT

About

MCP server for Hunter.io email discovery, verification, and enrichment

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors