fetch_employee_local_taxes
Retrieve local tax information for a specific employee from Paylocity payroll data. Use this tool to access tax details by providing employee and company identifiers.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | No | ||
| employee_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
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) - 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()