hatch_find_company_data

Retrieve detailed company information by entering a domain name. This tool helps users gather business data for research, verification, or outreach purposes.

Instructions

Find detailed information about a company using its domain.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`domain`	Yes	Company domain name

Implementation Reference

src/index.ts:443-476 (handler)

Handler for the 'hatch_find_company_data' tool: validates input using type guard, calls Hatch API endpoint '/v1/findCompanyData' with retry logic, returns JSON response or error.

case 'hatch_find_company_data': {
  if (!isFindCompanyDataParams(args)) {
    throw new McpError(
      ErrorCode.InvalidParams,
      'Invalid arguments for hatch_find_company_data'
    );
  }

  try {
    const response = await withRetry(
      async () => apiClient.post('/v1/findCompanyData', args),
      'find company data'
    );

    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        },
      ],
      isError: false,
    };
  } catch (error) {
    const errorMessage = axios.isAxiosError(error)
      ? `API Error: ${error.response?.data?.message || error.message}`
      : `Error: ${error instanceof Error ? error.message : String(error)}`;

    return {
      content: [{ type: 'text', text: errorMessage }],
      isError: true,
    };
  }
}

src/index.ts:71-84 (schema)

Tool schema definition including name, description, and input schema requiring 'domain' string.

const FIND_COMPANY_DATA_TOOL: Tool = {
  name: 'hatch_find_company_data',
  description: 'Find detailed information about a company using its domain.',
  inputSchema: {
    type: 'object',
    properties: {
      domain: {
        type: 'string',
        description: 'Company domain name',
      },
    },
    required: ['domain'],
  },
};

src/index.ts:313-320 (registration)
Registration of the tool in the listTools request handler by including FIND_COMPANY_DATA_TOOL in the tools array.
```
  tools: [
    FIND_EMAIL_TOOL,
    FIND_PHONE_TOOL,
    VERIFY_EMAIL_TOOL,
    FIND_COMPANY_DATA_TOOL,
    GET_LINKEDIN_URL_TOOL,
  ],
}));
```

src/index.ts:166-173 (helper)

Type guard helper function to validate arguments for hatch_find_company_data tool.

function isFindCompanyDataParams(args: unknown): args is FindCompanyDataParams {
  return (
    typeof args === 'object' &&
    args !== null &&
    'domain' in args &&
    typeof (args as { domain: unknown }).domain === 'string'
  );
}

src/index.ts:124-126 (helper)
TypeScript interface defining the input parameters for the tool.
```
interface FindCompanyDataParams {
  domain: string;
}
```

Hatch MCP Server