How to Use the UKG Pro MCP in LangChain

Q: What data does this UKG Pro server touch regarding payroll?

The payroll tool accesses current pay period records. This means you are working with sensitive financial transaction data, specifically salary and deduction amounts for active employees.

Q: Can I chain together job configuration and employee lookup using UKG Pro with LangChain?

Absolutely. You can run jobs first to verify a job code exists, then pass that resulting data into the employees tool call. The agent handles the sequence for you.

Build complex reasoning chains with UKG Pro using LangChain.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect UKG Pro MCP to LangChain

Create your Vinkius account to connect UKG Pro to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup UKG Pro with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Step Workflow Chains for MCP Server

You can build multi-step pipelines where the agent decides which tool to call and in what order. For example, an agent first runs `organizations` to get a department ID, then uses that ID to find employees via `employees`, finally pulling up payroll data using `payroll`. This chaining lets you run complex HR processes without manual intervention. The output of one call immediately becomes the necessary input for the next step in your LangChain agent.

Retrieving Specific Employee Data

Need a specific employee record? Use the `employees` tool by passing only an ID. This gets you immediate access to individual profiles, bypassing the need to search large lists first. You can check details on one person's employment status or job assignment right away. This direct lookup is crucial for agents that handle single-record requests. It saves latency and keeps your ReAct chain focused on a narrow scope.

Modeling Organizational Structures

The `organizations` tool lets you list out the full component structure of UKG Pro's company setup. You get a map of all departments, units, and divisions that make up the corporate framework. This gives your agent visibility into how the whole system is built. Knowing this hierarchy allows you to programmatically restrict searches later on. You can ensure subsequent calls only target valid organizational nodes.

Setup guide

Set up UKG Pro MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes UKG Pro tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "ukg-pro-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent UKG Pro transactions"
    })
    print(result["messages"][-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by UKG Pro. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect UKG Pro now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about UKG Pro MCP in LangChain

You pass the MCP tools list directly into your agent constructor. The LangChain framework handles schema conversion automatically, so you just need to define the initial prompt and let the agent figure out the calls.

The `payroll` tool accesses current pay period records. This means you are working with sensitive financial transaction data, specifically salary and deduction amounts for active employees.

Absolutely. You can run `jobs` first to verify a job code exists, then pass that resulting data into the `employees` tool call. The agent handles the sequence for you.

Yes. Because LangChain's strength is multi-step reasoning, it’s built to handle processes that require calling multiple tools in a specific, logical order—which is exactly what HR workflow management requires.

The server adheres to standard endpoint token authentication. Your AI client manages session context using `client.session()`, which keeps your work stateless and predictable across multiple calls.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript