find_email
Find email addresses for individuals by providing their full name and company domain, optionally using LinkedIn profiles for enhanced accuracy.
Instructions
Find an email address for a person.
Args:
full_name: The full name of the person
domain: The company domain or website
linkedin_url: Optional LinkedIn profile URL
custom_data: Optional custom data to associate with the request
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full_name | Yes | ||
| domain | Yes | ||
| linkedin_url | No | ||
| custom_data | No |
Implementation Reference
- server.py:41-64 (handler)The main handler function for the 'find_email' tool. It is registered via the @mcp.tool() decorator. The function takes full_name, domain, optional linkedin_url and custom_data, builds a payload, sends a POST request to the TryKitt API's /job/find_email endpoint, and returns the JSON response. This implements the core tool logic.@mcp.tool() async def find_email( full_name: str, domain: str, linkedin_url: Optional[str] = None, custom_data: Optional[str] = None, ) -> Dict: """ Find an email address for a person. Args: full_name: The full name of the person domain: The company domain or website linkedin_url: Optional LinkedIn profile URL custom_data: Optional custom data to associate with the request """ payload = {"fullName": full_name, "domain": domain, "realtime": True} if linkedin_url: payload["linkedinStandardProfileURL"] = linkedin_url if custom_data: payload["customData"] = custom_data response = await http_client.post("/job/find_email", json=payload) return response.json()
- server.py:42-56 (schema)Input schema defined by function parameters with type annotations (str, Optional[str]) and comprehensive docstring describing args and purpose. Output is Dict from API response.async def find_email( full_name: str, domain: str, linkedin_url: Optional[str] = None, custom_data: Optional[str] = None, ) -> Dict: """ Find an email address for a person. Args: full_name: The full name of the person domain: The company domain or website linkedin_url: Optional LinkedIn profile URL custom_data: Optional custom data to associate with the request """
- server.py:41-41 (registration)The @mcp.tool() decorator registers the find_email function as an MCP tool in the FastMCP server.@mcp.tool()