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
.envfile based on.env.exampleand 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.jsonon 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 keyHATCH_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 personlastName(required): Last name of the persondomain(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 persondesignation: Job title or designation of the personcompanyName(required): Company name
License
MIT