UKG Ready MCP
UKG Ready MCP
用于 UKG Ready REST 端点的 MCP 服务器,包括员工、考勤卡、异常、薪酬、已保存报表,以及一个通用的已认证端点工具。
配置
将 .env.example 复制到本地环境配置中,并设置:
UKG_BASE_URL:UKG 租户基础 URL,默认为https://secure.entertimeonline.com。UKG_API_KEY、UKG_USERNAME、UKG_PASSWORD、UKG_COMPANY。UKG_DEFAULT_REPORT_ID:可选的已保存报表 ID。
切勿提交真实凭据,也不要将其放入源文件中。
Related MCP server: woffu-mcp
运行
npm install
npm run build
npm start服务器通过 MCP stdio 进行通信。可用工具:
get_ukg_saved_report_csvlist_ukg_employeesget_ukg_employeeget_ukg_timecardslist_ukg_exceptionsget_ukg_compensationcall_ukg_endpoint
人力工具使用文档化风格的默认值,并暴露可选的 path 覆盖参数,因为 UKG Ready 端点的可用性因租户和已启用模块而异。通用工具接受任何 API 路径,因此凭据保留在服务器配置内部。仅在确认租户的端点契约和权限之后,再添加写入工具。
UKG 员工与 Command Cloud 驾驶员映射
预期的集成方式是 UKG 员工对应 Command Cloud 中的驾驶员。此映射是计划中的跨系统关系,目前还不是自动假设。
在实现时,应尽可能使用稳定标识符对记录进行核对,然后使用辅助字段(如员工/驾驶员姓名、员工编号、电话、电子邮件和在职状态)进行验证。保留 UKG 员工 ID 与 Command Cloud 驾驶员 ID 之间的显式映射;不要仅依赖姓名,因为姓名可能发生变化或重复。
该映射将支持未来的工作流,例如将 UKG 考勤卡或打卡状态与 Command Cloud 的驾驶员、调度和工单活动进行比较。在编写同步工具之前,仍需确认实际的匹配规则和权威数据源决策。
Available Tools
7 toolscall_ukg_endpointB
Call a UKG Ready REST endpoint with the configured credentials. Use this to explore tenant-enabled endpoints.
Inputs: path (required), body, query, accept, +1 more.
get_ukg_compensationA
Retrieve compensation data for an employee or the tenant's compensation collection.
Inputs: path, query, employeeId.
get_ukg_employeeA
Get one UKG Ready employee by ID.
Inputs: employeeId (required), path, query.
get_ukg_saved_report_csvA
Download a UKG Ready saved report as CSV. The report must be shared with the configured API user.
Inputs: reportId.
get_ukg_timecardsB
Retrieve timecards for an employee, optionally constrained by a date range.
Inputs: employeeId (required), path, query, endDate, +1 more.
list_ukg_employeesA
List employees visible to the configured UKG Ready API user.
Inputs: path, query.
list_ukg_exceptionsA
List timekeeping exceptions visible to the configured UKG Ready API user.
Inputs: path, query, endDate, startDate, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct purpose: report download, generic endpoint call, employee listing/retrieval, timecards, exceptions, and compensation. There is no ambiguity between them, and the generic call_ukg_endpoint does not overlap with specific operations because it is meant for exploration.
All tools follow a consistent pattern: <verb>_ukg_<noun>, with verbs like get_ for single resources, list_ for collections, and call_ for the generic endpoint. The naming is uniform and predictable.
Seven tools is well within the typical range for a focused HCM integration. Each tool serves a clear purpose, and the count feels neither sparse nor overwhelming.
The toolset covers core read operations for employees, time, compensation, and reports, but lacks write capabilities (create/update/delete) and other HCM modules. The generic call_ukg_endpoint partly offsets this by enabling direct API access, so the gaps are minor and workaroundable.
Related MCP Connectors
MCP server for Arcoro and ExakTime — workforce data, jobs, cost codes and locations.
Manage Timequip projects, tasks, comments, members, and dashboards through MCP.
isolved and ApplicantPro jobs, tenant discovery, and change detection as an MCP server.
Read employees, time clock, timesheets, time off, schedules and payroll data in WebClock.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Insperity's REST API to access employee data, including employee lists, check details, and profile information for HR management tasks.-
- AlicenseAqualityCmaintenanceEnables clocking in/out, viewing work status, and managing time entries on Woffu via MCP tools.94MIT
- AlicenseBqualityDmaintenanceExposes the Wealthbox CRM API to MCP-enabled clients, enabling operations on contacts, tasks, events, notes, opportunities, projects, workflows, and more.5123 npm4MIT
- AlicenseAqualityDmaintenanceEnables employee time tracking with clock-in/out, workday checking, and time log retrieval via MCP tools.41MIT