Hunter MCP Server

What is Hunter MCP Server about?

Provides integration between the Hunter API and any LLM provider that supports the MCP protocol, allowing users to query and manipulate Hunter B2B data (people, companies, leads) through conversational interfaces.

How to use Hunter MCP Server?

1. Install prerequisites – Python ≥ 3.13 and the uv package manager.
2. Add your Hunter API key to the environment (e.g., HUNTER_API_KEY).
3. Create an MCP configuration using the example JSON below, pointing PATH_TO_hunter-mcp/main.py to the repository's main.py file.
4. Run the server with uv run --with mcp[cli] mcp run PATH_TO_hunter-mcp/main.py or, for Claude Desktop, mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY.

Key Features

• Natural‑language wrappers around core Hunter endpoints: Domain Search, Email Finder, Email Verifier, Email Enrichment, Company Enrichment, Lead Creation.
• Works with any MCP‑compatible LLM (e.g., Claude for Desktop).
• Simple JSON‑based server configuration.
• MIT‑licensed and open source.

Use Cases

• Sales teams can ask an LLM to "find emails for contacts at example.com" and receive verified results instantly.
• Developers building conversational assistants can enrich lead data without writing HTTP request code.
• Market researchers can retrieve company information on‑the‑fly during analysis sessions.

FAQ

Q: Is the project still maintained? A: No. The repository is deprecated; functionality has moved to Hunter’s Remote MCP Server. See the official documentation for the new service.

Q: Which LLMs can I use? A: Any LLM that implements the MCP protocol, such as Claude for Desktop.

Q: Do all Hunter API endpoints work? A: Currently only the listed tools are supported; full endpoint coverage is planned for a future release.

Q: How do I set the API key? A: Add HUNTER_API_KEY to the env section of the MCP server config or export it in your shell before running the server.

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.