Connect your AI Agents to UKG Pro in minutes

What is a UKG Pro MCP?

A UKG Pro MCP server connects your agents to employee and workforce data through a set of callable tools. Your agents can invoke these tools to retrieve person and employment records, pull compensation details, track org structure changes, query PTO plans, and more.

UKG doesn't offer an MCP server purpose built for UKG Pro, but you can use one from a third-party platform, like Merge Agent Handler.

How can I use the UKG Pro MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

• Employee directory sync: When a new hire completes onboarding in your ATS, an agent pulls their person and employment details from UKG Pro and pushes a corresponding profile to the company directory tool, keeping both systems in sync without manual data entry

• PTO balance lookup from Slack: When an employee asks a Slack bot about their remaining time off, an agent queries UKG Pro for their PTO plan and current balance, then replies directly in the thread with the current figure

• Org chart updates on reporting changes: When a manager reassignment is recorded in UKG Pro, an agent detects the change via employee change tracking, retrieves the updated org level data, and pushes the new reporting structure to the company's org chart tool

• Compensation reporting for finance: On a scheduled basis, an agent pulls compensation details for a defined employee cohort from UKG Pro and posts a structured summary to a finance Slack channel, giving stakeholders current data without requiring direct system access

What are popular tools for UKG Pro's MCP server?

Here are some of the most commonly used tools:

• list_person_details: retrieves core employee records including name, contact information, and personal identifiers for employees across the organization. Useful for agents that need a complete employee roster before syncing data to another system

• list_employment_details: returns employment information such as hire date, status, job title, and work location for each employee. Call this when an agent needs employment context before creating or updating a record in a downstream tool

• list_compensation_details: fetches compensation data including pay rate, pay type, and effective dates. Good for workflows that generate finance reports or need to verify comp data before a payroll-adjacent process runs

• list_employee_changes: returns a log of recent employee record changes across fields like manager, location, title, and status. Use this when an agent needs to detect what changed and react accordingly rather than polling individual records

• list_org_levels: retrieves the organizational hierarchy levels defined in UKG Pro. Helpful when an agent needs to map reporting structures before building or updating an org chart in another tool

• get_employee_pto_plans: returns the PTO plan assignments and balances for a specific employee. Call this when an agent needs to respond to a time-off inquiry or verify eligibility before taking an action in a scheduling tool

What makes Merge Agent Handler's UKG Pro MCP server better than alternative UKG Pro MCP servers?

UKG Pro holds some of the most sensitive data in your organization, which makes several aspects of Merge Agent Handler especially relevant:

• Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For UKG Pro, this means you can prevent compensation figures, personal contact details, or employment status from being surfaced to agents that don't need that level of access

• Managed authentication and credentials: Merge stores and refreshes your UKG Pro API credentials on your behalf. You never pass raw credentials to an agent or deal with expired tokens breaking a workflow mid-run

• Real-time observability and audit trail: Every UKG Pro tool call is logged with the timestamp, tool name, input parameters, and response metadata. You can see exactly which employee records an agent read or which org changes it processed, with no custom instrumentation required

• Tool Packs and controlled access: Tool Packs let you scope exactly which UKG Pro tools each agent can reach. For example, a directory sync agent can get access to list_person_details and list_employment_details but never gets access to list_compensation_details, or other fields it has no reason to read

How can I start using Merge Agent Handler's UKG Pro MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account.

2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.

3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.

4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose UKG Pro and complete the credential setup. Merge stores and manages the credentials going forward.

5. Open a Claude Code session and start querying UKG Pro data directly. The first time you use a UKG Pro tool, a Magic Link may appear to complete connector authentication.

If you want to connect Merge Agent Handler's UKG Pro MCP with internal or customer-facing agentic products, you can follow the steps in our docs.