Skip to main content
Glama
ukg_pro_wfm_mcp_server

ukg_pro_wfm_mcp_server

by fvmuzik00

What This Is

This is not a thin OpenAPI wrapper.

This server is designed to behave like a UKG Pro WFM reasoning layer. It accepts natural language, determines what the user is really asking, resolves missing inputs, discovers the correct API path, hydrates partial objects, traverses references, validates completeness, scores confidence, and returns full operational answers.


Related MCP server: mcp-sling

Core Rule

Search and list endpoints are discovery only. They are not final truth.

If an API response contains IDs, references, partial objects, child references, parent references, profile references, or linked configuration, the server must hydrate those objects before answering.


Execution Model


Capabilities

Capability

Purpose

Natural language routing

Understands operational questions without requiring endpoint knowledge

Missing input resolution

Finds IDs, refs, dates, employees, groups, profiles, and related objects

Discovery-only enforcement

Prevents list/search responses from being treated as final truth

Universal hydration

Pulls full detail for every reachable partial object

Object graph traversal

Follows parent, child, profile, group, org, and setup references

Completeness validation

Calculates whether the answer is complete enough to return

Confidence scoring

Classifies answers as CERTAIN, HIGH, MEDIUM, LOW, or BLOCKED

Write safety

Requires hydration, dry-run, explicit confirmation, and re-read after writes

Audit logging

Records source chain, duration, confidence, and affected objects


Supported Domains

Domain

Coverage Intent

Attendance

Events, patterns, and attendance-related operational context

Common Resources

Shared objects, lookup values, Hyperfinds, and common references

Employee Self Service

Employee-facing objects and request flows

Forecasting

Forecast-related workforce planning data

Healthcare Productivity

Productivity and staffing context

HCM

HCM-connected workforce data

Leave

Leave cases, requests, balances, and related context

People

Person, employee, manager, job, and org details

Person Assignments

Assignments, roles, and workforce relationships

Platform

Tenant, metadata, and platform-level capabilities

Scheduling

Schedules, shifts, coverage, and schedule analysis

Scheduling Setup

Scheduling configuration and setup references

Timekeeping

Timekeeping objects and operational time data

Timekeeping Setup

Pay rules, work rules, pay codes, and setup metadata

Timekeeping Timecards

Timecards, punches, exceptions, totals, approvals

Timekeeping Bulk Operations

Controlled bulk workflows with guardrails

Universal Device Manager

Device and clock-related operational context

Webhook Events

Event subscriptions and event payload normalization


Hydration Behavior

Traditional API result:

Server behavior:

This applies to every object type, not just Known Places.


Confidence Levels

Level

Meaning

CERTAIN

Unique immutable identifier, full hydration, no unresolved dependencies, no conflicts

HIGH

Strong candidate, full target detail, minor non-critical references unavailable

MEDIUM

Likely answer, but some relevant references remain unresolved

LOW

Ambiguous or incomplete

BLOCKED

Cannot proceed safely because required data, access, or endpoint is unavailable


Architecture


Execution Pipeline


Primary Tool

ukg_wfm_ask

Use this for natural language requests.

Examples:


Write Safety

Every write operation follows the same lifecycle:

Write, delete, and bulk operations cannot execute from:

  • name-only matches

  • search results

  • partial objects

  • inferred identities

  • ambiguous references

Only fully hydrated targets are eligible for mutation.


Installation

Clone the repository:

Install dependencies:

Configure environment:

Required environment variables:

Start development server:

Build production:

Run tests:


Scorecard

Generate endpoint intelligence and risk outputs:

Outputs:

  • docs/endpoint-scorecard.json

  • docs/tool-risk-matrix.json


Project Goals

This project exists to eliminate three common problems in workforce management integrations:

  1. Partial answers

  2. Manual endpoint selection

  3. Missing relationship awareness

The server's responsibility is not merely to call APIs.

Its responsibility is to understand the request, discover what information is missing, retrieve that information, validate it, and return the most complete answer possible from the available system of record.

Available Tools

1 tool
ukg_wfm_askD

Universal natural language entry point with full hydration

Inputs: question (required), inputs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The single tool is uniquely identifiable.

    Naming Consistency5/5

    The single tool name follows a clear pattern: 'ukg_wfm' prefix plus an action verb 'ask'. Since there is only one name, consistency is trivially maintained.

    Tool Count3/5

    A single tool for a broad domain like workforce management feels thin, even if it is designed as a universal entry point. It is borderline: lightweight but potentially intentional for a natural-language interface.

    Completeness4/5

    The tool is described as a 'universal natural language entry point with full hydration', suggesting it can handle a wide range of WFM requests. However, without explicit confirmation of specific operations, there is a minor uncertainty about coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables interaction with the Sling scheduling and workforce management platform, allowing users to manage shifts, users, calendars, and reports through natural language.
      16
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying HR data like recent hires, employee details, departments, and PTO balances through natural language in an MCP client.
      -
    • F
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to manage Gerent365 restaurant and business operations via natural language, including employees, schedules, payroll, tips, time tracking, customers, products, reservations, and reports.
      53
      1
      -