mcpPaylocity

Instructions

Implementation Reference

• src/mcppaylocity/__init__.py:291-305 (handler)

  MCP tool handler for fetch_employee_local_taxes that validates input and calls PaylocityClient method

  @mcp.tool()
  def fetch_employee_local_taxes(company_id: Optional[Union[str, int]] = None, employee_id: Union[str, int] = None) -> Dict[str, Any]:
      """
      Fetch local taxes for a specific employee.
      
      Args:
          company_id: Optional company ID (string or integer). If not provided, uses the first company ID from configuration.
          employee_id: Employee ID (string or integer) to get local taxes for.
      """
      if employee_id is None:
          raise ValueError("employee_id is required")
          
      company_id_str = str(company_id) if company_id is not None else company_ids[0]
      employee_id_str = str(employee_id)
      return client.get_employee_local_taxes(company_id_str, employee_id_str)

• src/mcppaylocity/paylocity_client.py:147-150 (helper)

  PaylocityClient method implementing the API call to fetch employee local taxes using the /localTaxes endpoint with authentication and retry logic handled by _make_request

  def get_employee_local_taxes(self, company_id, employee_id):
      """Get all local taxes for a specific employee"""
      endpoint = "/api/v2/companies/{}/{}/localTaxes".format(company_id, employee_id)
      return self._make_request("GET", endpoint).json()