Skip to main content
Glama
UKG Ready MCP

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_csv

  • list_ukg_employees

  • get_ukg_employee

  • get_ukg_timecards

  • list_ukg_exceptions

  • get_ukg_compensation

  • call_ukg_endpoint

人力工具使用文档化风格的默认值,并暴露可选的 path 覆盖参数,因为 UKG Ready 端点的可用性因租户和已启用模块而异。通用工具接受任何 API 路径,因此凭据保留在服务器配置内部。仅在确认租户的端点契约和权限之后,再添加写入工具。

UKG 员工与 Command Cloud 驾驶员映射

预期的集成方式是 UKG 员工对应 Command Cloud 中的驾驶员。此映射是计划中的跨系统关系,目前还不是自动假设。

在实现时,应尽可能使用稳定标识符对记录进行核对,然后使用辅助字段(如员工/驾驶员姓名、员工编号、电话、电子邮件和在职状态)进行验证。保留 UKG 员工 ID 与 Command Cloud 驾驶员 ID 之间的显式映射;不要仅依赖姓名,因为姓名可能发生变化或重复。

该映射将支持未来的工作流,例如将 UKG 考勤卡或打卡状态与 Command Cloud 的驾驶员、调度和工单活动进行比较。在编写同步工具之前,仍需确认实际的匹配规则和权威数据源决策。

Available Tools

7 tools
call_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

    A3.8/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Insperity's REST API to access employee data, including employee lists, check details, and profile information for HR management tasks.
      -
    • A
      license
      B
      quality
      D
      maintenance
      Exposes the Wealthbox CRM API to MCP-enabled clients, enabling operations on contacts, tasks, events, notes, opportunities, projects, workflows, and more.
      51
      23 npm
      4
      MIT