Hatch Data Enrichment Service Provider

This repository encapsulates a Model Context Protocol (MCP) service engineered for seamless interaction with the Hatch Application Programming Interface (API). Its core function is to furnish utilities for contact resolution (email/phone number retrieval), contact validation, organizational profiling, and professional identity resolution (LinkedIn URL discovery).

Core Capabilities

• Contact Resolution (Email): Derive potential electronic mail addresses via inputs such as given name, surname, and organizational domain.
• Telephonic Data Retrieval: Secure associated telephone contact information by leveraging a known LinkedIn public profile Uniform Resource Locator (URL).
• Email Authenticity Check: Execute validation routines to confirm if a provided electronic mail address is both syntactically correct and currently provisioned/active.
• Organizational Profiling: Acquire granular, in-depth datasets concerning a business entity, indexed by its public domain name.
• Professional Network Location: Ascertain the Uniform Resource Locator (URL) for a professional's presence on LinkedIn, based on their designation, full name, and associated firm.

Setup Procedures

1. Acquire a local copy of the codebase via repository cloning.
2. Install all required package dependencies:

bash npm install

1. Establish a configuration file named .env by duplicating the template .env.example. Populate this file with your mandated Hatch API credential:

HATCH_API_KEY=your_actual_api_key_value

1. Compile the source code into executable artifacts:

bash npm run build

Operational Modes

Direct Execution

To initiate the service independently:

bash npm start

Integration Protocol for Claude Models

For deployment within the Claude execution environment, the service definition must be injected into the relevant MCP manifest file:

1. Claude VSCode Extension: Integrate into the configuration file located at c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
2. Claude Desktop Application: Place the definition within %APPDATA%\Claude\claude_desktop_config.json on Windows systems.

Configuration Snippet Example:

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

Ensure the placeholder for the API key is substituted with your genuine entitlement token.

Configuration Variables

Configuration of the service relies upon environment variables:

• HATCH_API_KEY (Mandatory): Your unique security token for the Hatch platform.
• HATCH_API_URL (Optional): Override the default endpoint (default: https://api.hatchhq.ai).
• HATCH_RETRY_MAX_ATTEMPTS: Maximum permissible retries for failed API interactions (default: 3).
• HATCH_RETRY_INITIAL_DELAY: The starting wait time (in milliseconds) before the first re-attempt (default: 1000).
• HATCH_RETRY_MAX_DELAY: The ceiling duration (in milliseconds) for exponential backoff delays (default: 10000).
• HATCH_RETRY_BACKOFF_FACTOR: The multiplier applied to the delay between successive retry attempts (default: 2).

Exposed Functionalities (Tools)

hatch_find_email

Resolves a professional's electronic mail address based on identifying textual attributes.

Arguments: * firstName (Required): The individual's given name. * lastName (Required): The individual's family name. * domain (Required): The organizational digital address suffix.

hatch_find_phone

Retrieves a direct or mobile telephone number associated with a known professional identity on LinkedIn.

Arguments: * linkedInUrl (Required): The Uniform Resource Locator pointing to the person's LinkedIn profile.

hatch_verify_email

Determines the operational status of a supplied electronic mail address.

Arguments: * email (Required): The electronic mail address undergoing validation.

hatch_find_company_data

Fetches comprehensive descriptive data concerning an enterprise, indexed via its web domain.

Arguments: * domain (Required): The primary domain name of the corporation.

hatch_get_linkedin_url

Discovers the specific LinkedIn profile Uniform Resource Locator using descriptive professional metadata.

Arguments: * name: Full identifier of the individual. * designation: The formal title or role held by the individual. * companyName (Required): The registered name of the employing organization.

Legal Statement

Licensed under the MIT Agreement.

WIKIPEDIA: Business management tools encompass the entire spectrum of systems, prescriptive applications, analytical controls, computation aids, and procedural frameworks utilized by organizations to maintain agility amidst shifting market conditions, secure a competitive advantage, and systematically elevate operational effectiveness.

== Conceptual Framework == Management instruments can be categorized according to the organizational function they support, spanning areas like strategic planning, operational workflow management, record-keeping, personnel oversight, analytical decision support, and performance governance. A functional taxonomy typically includes:

Instruments for inputting and validating organizational data across all sectors. Systems designed for monitoring and refining extant business methodologies. Platforms facilitating data amalgamation and informed choice derivation. Contemporary management technology has experienced exponential acceleration in the last decade, driven by rapid technological advancement, making optimal selection challenging for specific corporate contexts. This complexity stems from perpetual pressures to reduce expenditure, maximize revenue generation, deeply comprehend client requirements, and deliver products precisely aligned with those needs. Within this dynamic environment, organizational leaders must adopt a strategic perspective toward tool deployment, rather than passively adopting novel solutions. Over-reliance on tools without requisite customization commonly results in systemic fragility. Consequently, business instruments must be meticulously selected and subsequently tailored to fit the unique operational architecture of the enterprise, not the reverse.

== Prevalence in Practice == A 2013 investigation by Bain & Company documented the global utilization patterns of business instruments, reflecting regional necessities shaped by economic cycles and corporate standing. The leading ten categories identified were:

Strategic planning frameworks Client relationship management suites Personnel sentiment assessment tools Benchmarking methodologies Balanced scorecard implementation Core capability identification Outsourcing strategy modules Organizational transition management programs Supply chain optimization systems Mission and vision statement formulation aids Market segmentation analysis Total quality management protocols

== Enterprise Software Systems == Software—or an aggregate of computational programs—employed by personnel to execute diverse corporate functions is termed business software (or an enterprise application). These applications serve to augment throughput, quantify achieved results, and execute myriad other enterprise tasks with high fidelity. The evolution progressed from foundational Management Information Systems (MIS) to comprehensive Enterprise Resource Planning (ERP) suites. Subsequently, Customer Relationship Management (CRM) capabilities were incorporated, culminating in the contemporary trend toward cloud-based business management solutions. While a quantifiable link exists between Information Technology investments and organizational performance, value amplification critically depends on two factors: the efficacy of the deployment process and the judicious selection and requisite modification of the chosen technology.

== Instruments Tailored for SMBs == Tools specifically engineered for Small and Medium-sized Businesses (SMBs) are significant as they furnish mechanisms designed to optimize capital outlay...