> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # UKG Pro **Authentication:** username + password + customer API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * List employees with anniversaries this month for recognition notes. * Pull current PTO balances by department. * Find employees who haven't completed the Q2 compliance training. ## Available Tools #### list_companies List company details from UKG Pro with pagination. Returns company names, IDs, addresses, and other company configura... #### get_company Get a specific company by ID. Returns company name, address, and configuration details. Use list_companies to find va... #### list_compensation_details List compensation details from UKG Pro with pagination. Returns salary, pay rate, pay frequency, and other compensati... #### get_compensation_details Get compensation details for a specific employee by ID. Returns salary, pay rate, pay frequency, and other compensati... #### list_employee_demographics List employee demographic details from UKG Pro with pagination. Returns names, addresses, contact info, and other dem... #### get_employee_demographics Get demographic details for a specific employee by ID. Returns name, address, contact info, and other demographic data. #### list_person_details List person details from UKG Pro with pagination. Returns personal information including date of birth, gender, ethni... #### get_person_details Get person details for a specific employee by ID. Returns personal information including date of birth, gender, ethni... #### list_employment_details List employment details from UKG Pro with pagination. Returns hire date, status, job title, department, and other emp... #### get_employment_details Get employment details for a specific employee by ID. Returns hire date, status, job title, department, and other emp... #### list_job_history List employee job history details from UKG Pro with pagination. Returns job changes, promotions, transfers, and other... #### get_employee_job_history Get job history for a specific employee by ID. Returns all job changes, promotions, transfers, and other employment h... #### list_employee_changes List employee changes from UKG Pro with pagination. Returns recent changes to employee records including new hires, t... #### list_locations List locations from UKG Pro with pagination. Returns location names, addresses, codes, and other location configurati... #### get_location Get a specific location by ID. Returns location name, address, and configuration details. Use list_locations to find ... #### list_org_levels List organization levels from UKG Pro with pagination. Returns org level codes, names, and hierarchy data used to def... #### get_org_level Get a specific organization level by code. Returns org level name, hierarchy, and configuration details. Use list_org... #### list_positions List positions from UKG Pro with pagination. Returns position codes, titles, departments, and other position configur... #### get_position Get a specific position by position code. Returns position title, department, and configuration details. Use list_pos... #### list_pto_plans List PTO plans from UKG Pro with pagination. Returns all PTO plan configurations including plan names, accrual rates,... #### get_employee_pto_plans Get PTO plans for a specific employee. Requires company ID and employee ID. Use list_companies to find the company ID.