# UKG Pro MCP > UKG Pro MCP connects your AI client directly to UKG Pro's human capital management data. Your agent can look up employee details, map organizational structures, check job configurations by code, and retrieve payroll records for the current pay period. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** hcm, employee-records, payroll-management, organizational-structure, hr-automation, personnel-data ## Description This connector lets your AI client interact with core HR systems, pulling actionable data from UKG Pro without logging into a dashboard or running complex reports. Need to know who reports to whom? Your agent can pull the organizational structure. Want to verify if someone's direct deposit was processed? You can fetch current payroll records. The system also lets you look up specific employee profiles using an ID, and retrieve details on job roles by their code. It’s a single access point for critical personnel data and HR workflows. When you connect UKG Pro through Vinkius, your agent gets all these functions managed in one place, letting you focus purely on the insights, not the integration steps. ## Tools ### organizations Lists all components and structures within the company’s organizational chart. ### employees Retrieves a specific employee's data when provided with their unique ID number. ### jobs Looks up the full configuration details for any job role using its specific job code. ### payroll Fetches all payroll data associated with the current pay period run. ## Prompt Examples **Prompt:** ``` List the contact details for employee ID 12345. ``` **Response:** ``` Here are the contact details for employee 12345: John Doe, Email: john.doe@example.com... ``` **Prompt:** ``` Show the current organizational reporting structure for the 'Marketing' division. ``` **Response:** ``` Querying UKG Pro organization charts ('get_org_metrics')... Marketing Division hierarchy: - VP of Marketing: Sarah Jenkins |- Director of Content: Mark D. |- Director of SEO: Alice R. Total active headcounts beneath VP: 45. ``` **Prompt:** ``` Verify the payroll status for the latest bi-weekly run. ``` **Response:** ``` Fetching payroll parameters ('get_payroll_status')... The bi-weekly run (Pay Period: Oct 1 - Oct 15) is 'Completed'. Direct deposits were dispatched successfully on Oct 17. Gross payroll total: $450,210. ``` ## Capabilities ### Map Organizational Hierarchy List all organizational components and show how they are structured. ### Retrieve Employee Profiles Fetch specific employee records using their unique ID number. ### Verify Job Definitions Get job configuration details by looking up the associated job code. ### Pull Payroll Records Access payroll data for the current pay period for immediate review. ## Use Cases ### Answering a quick internal transfer question A manager needs to know what department Sarah Jenkins reports into after she moved. Instead of checking the intranet, they ask their agent to list organizational components, immediately getting the updated reporting structure. ### Auditing payroll discrepancies The finance team suspects an error in a recent paycheck. They instruct their agent to pull payroll records and then use the employees tool with the employee ID to cross-reference contact details and salary bands. ### Onboarding a new hire's role HR needs to confirm that the new job title, 'Senior Analyst,' matches the official company structure. They use the jobs tool by code to ensure the configuration is valid before creating the profile. ### Building an org chart for a presentation A department head needs to present the full hierarchy of their division. The agent uses the organizations tool, which automatically compiles and structures all required reporting lines into one clean output. ## Benefits - You can instantly map the entire company's reporting structure by invoking the organizations tool, eliminating manual chart building. - Instead of searching multiple records, your agent fetches a specific employee’s full profile using just their ID with the employees tool. - Quickly validate job roles: checking any job code against the jobs tool guarantees you have the correct configuration before processing payroll. - Verify paychecks immediately. The payroll tool pulls all necessary financial data for the current period, saving hours of report generation. - It centralizes HR knowledge. All four tools—organizations, employees, jobs, and payroll—are available through one connection point. ## How It Works The bottom line is you get real-time access to sensitive HR and payroll data through natural language prompts, skipping the manual dashboard steps entirely. 1. You instruct your AI client to perform a task, like 'Show me the reporting lines for department X.' 2. Your agent sends that request through this MCP, which translates it into a query for UKG Pro's internal data. 3. The system returns clean, structured HR information—like employee names or payroll totals—right back to your AI client. ## Frequently Asked Questions **How do I find out who works in a department using the UKG Pro MCP?** You use the organizations tool. It lists all organizational components and structures within the company, letting you map reporting lines instantly. **Can the UKG Pro MCP check if an employee ID is valid?** Yes, by using the employees tool with a specific ID, your agent retrieves that employee's full profile. This confirms existence and pulls all associated data points. **What tools are available in the UKG Pro MCP for payroll?** You have two key options: running the payroll tool to get records for the current pay period, or using the jobs tool to verify if a specific job code affects payments. **Is this UKG Pro MCP better than manually downloading reports?** Absolutely. Instead of dealing with static CSVs that require manual interpretation, this MCP gives you live data retrieval directly through your agent's conversational interface. **Which tool do I use to verify a job role's details?** Use the jobs tool. You only need to provide the specific job code, and it returns all associated configuration information for that role.