trykittai-mcp-server

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

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()