keila-mcp

Instructions

Implementation Reference

• mcp_server.py:48-61 (handler)

  The MCP tool registration and handler wrapper for creating a contact.

  @mcp.tool()
  def create_contact(email: str, first_name: str | None = None, last_name: str | None = None) -> dict:
      """
      Create a new contact in Keila.
  
      Args:
          email: Email address (required).
          first_name: First name (optional).
          last_name: Last name (optional).
  
      Returns:
          The created contact record.
      """
      return _client.create_contact(email=email, first_name=first_name, last_name=last_name)

• client.py:58-72 (handler)

  The actual Keila API client implementation that sends the request to create a contact.

  def create_contact(self, email: str, first_name: str | None = None, last_name: str | None = None,
                     external_id: str | None = None, data: dict | None = None) -> dict:
      """Create a new contact."""
      contact_data = {"email": email}
      if first_name:
          contact_data["first_name"] = first_name
      if last_name:
          contact_data["last_name"] = last_name
      if external_id:
          contact_data["external_id"] = external_id
      if data:
          contact_data["data"] = data
      resp = self.session.post(f"{self.url}/api/v1/contacts", json={"data": contact_data}, headers=self._headers(), timeout=30)
      resp.raise_for_status()
      return resp.json()