Connect your AI Agents to UKG Pro WFM in minutes

What is a UKG Pro WFM MCP?

It's an MCP server that connects your agents to workforce management data and functionality in UKG Pro WFM via tools. Your agents can invoke these tools to retrieve employee schedules, query timecard data, track shift assignments, manage time-off requests, and more.

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

How can I use the UKG Pro WFM MCP server?

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

• Shift coverage alerts: When an employee calls out sick via a messaging tool, an agent queries UKG Pro WFM for open shifts on that day, identifies available employees based on schedule and labor rules, and sends targeted coverage requests, reducing the time managers spend manually finding replacements

• Timecard exception reporting: On a scheduled basis, an agent pulls timecard data from UKG Pro WFM, flags exceptions such as missed punches or overtime thresholds, and posts a structured summary to a manager's Slack channel so issues get resolved before payroll closes

• Cross-system schedule sync: When a new shift template is created in UKG Pro WFM, an agent retrieves the updated schedule and pushes it to a project management tool or external calendar, keeping operational plans aligned without manual exports

• Labor cost summaries for operations leaders: An agent aggregates hours worked and pay category data from UKG Pro WFM across departments, then delivers a weekly labor cost digest to operations leadership, giving them current figures without requiring direct system access

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

Here are some of the most commonly used tools:

• list_employee_schedules: retrieves scheduled shifts for employees across a defined date range and location. Useful for agents that need to assess coverage levels or detect gaps before taking an action in another system

• get_timecard_data: fetches timecard records including punch times, pay categories, and hours worked for a given employee and period. Call this when an agent needs to verify hours before generating a report or flagging an exception

• list_shift_assignments: returns shift assignment records tied to specific employees, job codes, or departments. Good for workflows that need to match open shifts with available workers or validate staffing against demand forecasts

• list_time_off_requests: pulls pending and approved time-off requests from UKG Pro WFM. Helpful when an agent needs to factor leave into scheduling decisions or surface upcoming coverage gaps to a manager

• get_labor_categories: retrieves the labor category definitions configured in UKG Pro WFM, such as pay codes and job classifications. Use this when an agent needs to label or route work records accurately before posting to a downstream system

• list_employee_availability: returns employee availability preferences and constraints. Call this when an agent is filling an open shift and needs to filter candidates by who is eligible to work before sending a coverage request

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

There are several reasons to choose Merge Agent Handler's UKG Pro WFM MCP server over building or relying on an alternative:

• 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 WFM, this means you can prevent employee pay rates, personal identifiers, or disciplinary flags from being surfaced to agents that have no reason to see that data

• Managed authentication and credentials: Merge stores and refreshes your UKG Pro WFM credentials on your behalf. You never expose raw API keys or OAuth tokens to an agent, and you don't need to build token rotation logic yourself

• Real-time observability and audit trail: Every tool call made against UKG Pro WFM is logged with timestamp, tool name, input parameters, and response metadata. You know exactly which schedule records or timecard entries an agent read, without adding any custom instrumentation to your pipeline

• Tool Packs and controlled access: Tool Packs let you bundle specific UKG Pro WFM tools with tools from other connectors into a single MCP endpoint, scoped to a particular workflow. A scheduling agent gets exactly the shift and availability tools it needs, with no access to payroll or compensation data it shouldn't touch

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

You can take the following steps (assuming you use Claude Code):

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 WFM and complete the auth flow. Merge stores and manages the credentials going forward.

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

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

Can employees use Merge Agent Handler to connect their AI tools to UKG Pro WFM?

Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to UKG Pro WFM without bypassing IT governance.

Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity. A frontline operations manager can ask their AI to pull up the week's schedule, flag timecard exceptions, or check staffing levels, all within the permissions IT has defined.

IT also provisions access by role or group via SCIM. A workforce planner, for example, gets UKG Pro WFM access to manage schedules and labor forecasts, Slack to coordinate with team leads, and Google Sheets to track headcount metrics; while a payroll analyst gets UKG Pro WFM access to pull timecard and pay category data, ADP to process payroll runs, and Workday to reconcile compensation records.

Every tool call an employee's AI makes to UKG Pro WFM is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.