home / mcp / hunter mcp server

Hunter MCP Server

Provides integration between the Hunter API and any LLM provider supporting the MCP protocol

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hunter-io-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"
      }
    }
  }
}

You can run the Hunter MCP Server to enable natural language access to Hunter API data through any MCP-compatible client. This server translates conversational prompts into Hunter API requests, letting you explore People, Companies, and related data via chat-like interactions.

How to use

Connect your MCP client (for example Claude Desktop or any other MCP-enabled tool) to the Hunter MCP Server. Start the server, then interact with it using natural language prompts to search domains, find emails, enrich company records, or create leads. The integration focuses on providing conversational access to Hunter data and saves relevant results as Leads through the chat interface.

How to install

Prerequisites: install and configure the software environment before starting the MCP server.

Steps to get started:

1) Ensure you have a Hunter API key and a Python runtime.

2) Create the MCP configuration file with the provided example.

3) Run the MCP install command to prepare and start the server.

Configuration notes

The server uses a local standard I/O runtime to start the MCP process. You will provide your Hunter API key as an environment variable to authorize requests.

The example configuration shows how to wire the local command to run the MCP and supply the API key.

You can start the server using the shown command and then connect your MCP client to it to begin asking questions about Hunter data.

Security and dependencies

Keep your Hunter API key secure. Do not embed it in code that is shared publicly. The server relies on Python and the uv tool to run the MCP loop.

Ensure your runtime environment meets the prerequisites before starting the server to avoid authentication or runtime errors.

Troubleshooting tips

If you encounter connection issues, verify that the MCP client is configured to target the local MCP server and that the Hunter API key is correctly provided in the environment.

Available tools

Domain Search

Query domains to find related company or person data using natural language prompts.

Email Finder

Discover email addresses associated with a domain or a person within a company.

Email Verifier

Check the deliverability and validity of email addresses.

Email Enrichment

Enrich records with additional email context and metadata.

Company Enrichment

Enrich company profiles with updated information and attributes.

Lead Creation

Create and save new leads to your Leads list through conversational prompts.