Hunter MCP Server

What is Hunter MCP Server about?

Provides integration between the Hunter API and LLM providers that support the MCP protocol, allowing users to query people and company information, verify and enrich emails, and create leads through conversational interfaces.

How to use Hunter MCP Server?

1. Prerequisites: Obtain a Hunter API key, install Python 3.13+, and install the uv package manager.
2. Installation: Clone the repository and run the server with uv run --with mcp[cli] mcp run PATH_TO_hunter-mcp/main.py.
3. MCP configuration: Add the following entry to your MCP client configuration:

{
  "mcpServers": {
    "hunter-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "PATH_TO_hunter-mcp/main.py"
      ],
      "env": { "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY" }
    }
  }
}

4. Quick start (Claude Desktop): mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY.

Key Features

• Natural‑language access to Hunter API endpoints via MCP.
• Supports domain search, email finder, email verifier, email enrichment, company enrichment, and lead creation.
• Works with any MCP‑compatible LLM provider (e.g., Claude for Desktop).
• Simple JSON‑based server configuration.

Use Cases

• Sales teams generate leads by asking an LLM to find contacts for a target domain.
• Marketing automation enriches email lists with verified and enriched data through chat.
• Developers embed B2B data retrieval into conversational assistants without writing API calls.
• Researchers query company information conversationally for market analysis.

FAQ

Q: Is the repository still maintained? A: No. The functionality has moved to Hunter’s Remote MCP Server. The local server is deprecated.

Q: Which programming language is required? A: Python 3.13+ and the uv package manager.

Q: Can I use this with other LLMs besides Claude Desktop? A: Yes, as long as the LLM provider implements the MCP protocol.

Q: Are all Hunter API endpoints available? A: Currently only the listed tools are supported; additional endpoints will be added in future releases.

Q: How do I provide my API key? A: Set the HUNTER_API_KEY environment variable in the MCP server configuration.

Hunter MCP Server

⚠️ Deprecated - Please Switch to Hunter's Remote MCP Server ⚠️

This repository is no longer maintained. All functionality has moved to Hunter’s Remote MCP Server, which provides a more convenient setup.

👉 Start here: https://hunter.io/api-documentation#mcp

---

🙋‍♂️ Introduction

This MCP (Model Context Protocol) server provides integration between the Hunter API and any LLM provider supporting the MCP protocol (e.g., Claude for Desktop), allowing you to interact with the Hunter B2B data using natural language.

✨ Features

• Use Hunter API endpoints using natural language
• Get B2B data about People and Companies
• Save them to your Leads through conversational interfaces

📦 Installation

Prerequisites

• A Hunter API key
• Python 3.13 or higher
• uv

🔌 MCP setup

Here is an example config file which you can use to set up Hunter MCP.

{
  "mcpServers": {
    "hunter-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "PATH_TO_hunter-mcp/main.py"
      ],
      "env": {
        "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
      }
    }
  }
}

For Claude Desktop, you can install and interact with it right away by running:

mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY

🔎 Example

🚀 Available Tools

The Hunter MCP server provides access to various Hunter API endpoints as tools.

The current version offers the following tools:

• Domain Search
• Email Finder
• Email Verifier
• Email Enrichment
• Company Enrichment
• Lead Creation

Note: All the Hunter API endpoints are not supported, yet. This will be addressed in a future release.

🔑 License

This project is licensed under the MIT License; see the LICENSE.md file for details.