How to Use the UKG Ready MCP in Vercel AI SDK

Q: How do I check job applicants with UKG Ready using the Vercel AI SDK?

Just call mcpClient.tools() and select applicants. The resulting data stream gives you a list of candidates' names and application statuses from UKG Ready. You won't have to deal with bulky API payloads.

Q: Is the Vercel AI SDK good for real-time payroll history retrieval from UKG Ready?

Yeah, it's built for streaming. When you call payroll, the data appears in your UI live—it doesn't wait until a loading spinner disappears. That makes the whole experience much smoother.

Q: What specific data can I get when checking employees with UKG Ready using the Vercel AI SDK?

The employees tool returns core HR data like names, department codes, and employment statuses. This is clean, structured info perfect for displaying in a web application.

Q: Does the MCP Server support fetching timesheets with UKG Ready using the Vercel AI SDK?

Absolutely. The timesheets tool handles that. It grabs employee work logs and associated hours, giving you precise data on who worked when.

Q: If I need to check payroll data privacy with UKG Ready using the Vercel AI SDK, what type of data is exposed?

The server exposes structured payroll history. You'll get records containing pay period dates and calculated gross/net amounts.

Stream live UKG Ready data into your UI with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect UKG Ready MCP to Vercel AI SDK

Create your Vinkius account to connect UKG Ready to Vercel AI SDK 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 Ready with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Current Staff Listings

The `employees` tool fetches a current list of active staff members from UKG Ready. You get names, roles, and employee IDs instantly. This works great for populating UI components in real time. Instead of showing a spinner, your user sees the data appear as it streams into the React component.

Retrieve Applicant Details

Use the `applicants` tool to pull details on job candidates through UKG Ready. It returns status and basic contact info for each record. This lets you build a recruitment dashboard that updates live as your agent processes candidate data.

Run Payroll or Timesheet Checks

You can call `payroll` to get historical pay records, or use `timesheets` for current work hours. Both tools pull structured financial and time data from UKG Ready. This capability lets you build mission-critical reporting features right into your user's browser.

Setup guide

Set up UKG Ready MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all UKG Ready tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent UKG Ready transactions",
});

console.log(text);
await mcpClient.close();

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 Ready. 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 Ready 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 Ready MCP in Vercel AI SDK

Just call `mcpClient.tools()` and select `applicants`. The resulting data stream gives you a list of candidates' names and application statuses from UKG Ready. You won't have to deal with bulky API payloads.

Yeah, it's built for streaming. When you call `payroll`, the data appears in your UI live—it doesn't wait until a loading spinner disappears. That makes the whole experience much smoother.

The `employees` tool returns core HR data like names, department codes, and employment statuses. This is clean, structured info perfect for displaying in a web application.

Absolutely. The `timesheets` tool handles that. It grabs employee work logs and associated hours, giving you precise data on who worked when.

The server exposes structured `payroll` history. You'll get records containing pay period dates and calculated gross/net amounts.

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