hatch-mcp-server

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

1. Clone the repository
2. Install dependencies:

npm install

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

HATCH_API_KEY=your_api_key_here

4. 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:

1. For Claude VSCode extension, add it to c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
2. 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