hatch-mcp-server

hatch-mcp-server

0
communicationdeveloper_toolsresearch_and_data

Hatch MCP Server facilitates integration with the Hatch API to perform tasks such as email and phone number retrieval, email verification, company data lookup, and LinkedIn URL finding. It is designed for ease of use, providing standalone or integrative capabilities with tools like Claude.

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
  1. Create a .env file based on .env.example and add your Hatch API key:
HATCH_API_KEY=your_api_key_here
  1. 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