hunter-mcp

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.