Hatch MCP Server

This is a Model Context Protocol (MCP) server for Hatch API integration. It provides tools for finding emails, phone numbers, verifying emails, finding company data, and getting LinkedIn URLs.

Features

Find email addresses using first name, last name, and domain information
Find phone numbers using LinkedIn profile URLs
Verify if an email address is valid and active
Find detailed information about a company using its domain
Find LinkedIn URLs using name, designation, and company information

Installation

Clone the repository
Install dependencies:

npm install

Create a .env file based on .env.example and add your Hatch API key:

HATCH_API_KEY=your_api_key_here

Build the project:

npm run build

Usage

Standalone Usage

To start the server directly:

npm start

Integration with Claude

To use this MCP server with Claude, you need to add it to the MCP settings file:

For Claude VSCode extension, add it to c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
For Claude desktop app, add it to %APPDATA%\Claude\claude_desktop_config.json on Windows

Example configuration:

{
  "mcpServers": {
    "hatch": {
      "command": "node",
      "args": ["E:/mcp-servers/hatch/dist/index.js"],
      "env": {
        "HATCH_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Replace your_api_key_here with your actual Hatch API key.

Configuration

The server can be configured using environment variables:

HATCH_API_KEY (required): Your Hatch API key
HATCH_API_URL (optional): Custom API URL (defaults to https://api.hatchhq.ai)
HATCH_RETRY_MAX_ATTEMPTS: Maximum retry attempts for API calls (default: 3)
HATCH_RETRY_INITIAL_DELAY: Initial delay in milliseconds for retries (default: 1000)
HATCH_RETRY_MAX_DELAY: Maximum delay in milliseconds for retries (default: 10000)
HATCH_RETRY_BACKOFF_FACTOR: Backoff factor for retry delays (default: 2)

Available Tools

hatch_find_email

Find an email address using first name, last name, and domain information.

Parameters:

firstName (required): First name of the person
lastName (required): Last name of the person
domain (required): Company domain name

hatch_find_phone

Find a phone number using LinkedIn profile URL.

Parameters:

linkedInUrl (required): LinkedIn profile URL of the person

hatch_verify_email

Verify if an email address is valid and active.

Parameters:

email (required): Email address to verify

hatch_find_company_data

Find detailed information about a company using its domain.

Parameters:

domain (required): Company domain name

hatch_get_linkedin_url

Find LinkedIn URL using name, designation, and company information.

Parameters:

name: Name of the person
designation: Job title or designation of the person
companyName (required): Company name

License

MIT