# UKG Ready MCP connector The UKG Ready connector brings employee records, accrual balances, deductions and direct deposits into Claude, ChatGPT, Cursor and the Elaichi Agent, so each person works with the UKG Ready access they already have and every change is logged. Source: https://elaichi.ai/connectors/ukgready/ ## Facts | | | | --- | --- | | Application | UKG Ready | | Category | HRIS | | AI tools | 358 | | Authentication | Connects with an API key | | Bring your own OAuth app | No | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead | ## What you can ask once UKG Ready is connected - Show accrual balances for everyone on the warehouse team. - Update Maria Lopez's direct deposit to her new checking account. - Add a 401k deduction for the three new hires starting Monday. ## Connect UKG Ready in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick UKG Ready. 2. Optionally set Share with, then press Connect. 3. Paste an UKG Ready API key. One person generates a token in UKG Ready and pastes it once. Everyone else works through Share with, and never sees it. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which UKG Ready tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## UKG Ready MCP connector for Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## UKG Ready MCP connector for ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## UKG Ready MCP connector for Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect UKG Ready to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a UKG Ready tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with UKG Ready through Elaichi ### Set up a new hire before day one HR. Create the employee record in UKG Ready from the offer details, then check it back a week later and fill in anything the hire has since sent over. ### Fix a direct deposit before payroll closes Payroll. When an employee sends new bank details, update their direct deposit in UKG Ready and confirm the change landed before the run. ### Add deductions after open enrollment Benefits. Set up the new deductions for everyone who changed a plan, and correct the ones that were entered wrong the first time. ### Answer time off questions on the spot People Ops. Pull accrual balances for a person or a whole team in UKG Ready when a manager asks who can take the last week of December. ### Review deductions across the company Finance. List employee deductions in UKG Ready ahead of a close and spot the ones that look out of line before they hit the ledger. ### Keep company contacts and profiles current Operations. Add a new site contact or check a company profile in UKG Ready without waiting for someone in HR to find a spare minute. ## Frequently asked questions ### How do I connect UKG Ready to Claude? Connect UKG Ready to Claude in two steps. In Elaichi, choose UKG Ready and paste an API key from your UKG Ready account; there is no OAuth application to register and no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Sign in with your Elaichi account and UKG Ready is ready to use in Claude. ### Does UKG Ready work with ChatGPT and Cursor as well as Claude? Yes. Once UKG Ready is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect UKG Ready once and every client you use picks it up. ### What can an AI agent actually do with my UKG Ready data? With UKG Ready connected, an agent can look up an employee, list a team's accrual balances, add or correct a deduction, update a direct deposit, and create a new employee record or company contact. It can also list company profiles and check its own employee details. Short, concrete asks such as "show Priya's PTO balance" work better than long paragraphs. ### Does connecting UKG Ready give the AI access to every employee's pay and personal details? No. Each person signs in as themselves, so the AI only sees the UKG Ready employees, deductions and direct deposits that person can already see in UKG Ready. Elaichi can narrow that access further for a team or a role, and it can never widen it beyond what UKG Ready already allows. ### Can my team share one UKG Ready connection? Yes. One administrator connects UKG Ready with the API key and shares the connection with a team, and nobody else on the team ever handles that key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every UKG Ready change. ### Can I stop an agent from deleting or changing things in UKG Ready? Yes. Restrictions in Elaichi work per action, so you can allow reading UKG Ready employees and accrual balances while blocking deletes or edits to direct deposits and deductions. A restricted action is never shown to Claude, ChatGPT or any other client at all, so no prompt, however worded, can reach it. ### What happens to a UKG Ready connection when someone leaves? Offboarding a person in Elaichi ends their access to UKG Ready through every client at once. A shared UKG Ready connection keeps working for everyone else on the team. If you ever want to remove UKG Ready entirely, disconnect it once in Elaichi and it disappears from Claude, ChatGPT, Cursor and the Elaichi Agent together. ### Does the UKG Ready MCP connector work with Gemini, Codex, Claude Code or other MCP clients? Yes. UKG Ready is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs. ## All 358 UKG Ready tools Every tool below is callable through https://api.elaichi.ai/mcp once UKG Ready is connected, subject to the toolbox it is in and the restrictions on the caller. - **List all UKG Ready company profiles** (List). List company profiles in UKG Ready, optionally filtered by profile type. Deprecated as of April 03, 2023; see the v2 companies lookup profiles endpoints as an alternative. Returns: id, name, type. No required parameters. The filter supports field name `type` with the `IN` operator, e.g. type:in:PAY_CALC_PROFILE,ACCESS_PROFILE_DEVICE. - **List all UKG Ready employees** (List). List employees the authenticated user has permission to view in UKG Ready. Returns: id, full_name, account_status, employee_id, username, external_id. Optional: ein_id, terminated. Required: cid. - **Get single UKG Ready employee by ID** (Get). Get a single UKG Ready employee by id. Returns the core employee record including id, full_name, account_status, employee_id, username, and external_id. Required: id, cid. - **Create a UKG Ready employee** (Create). Create a new employee record in UKG Ready covering core employee fields. Additional API calls are required for related data such as pay information or demographics. Returns: id. Requires a JSON request body. Required: cid. - **Delete a UKG Ready employee by ID** (Delete). Delete a UKG Ready employee by id. Deletion is restricted when the Pay Statement status is Open, Closed, or Finalized, and employees who are their own manager cannot self-delete. Returns an empty 204 response on success. Required: id, cid. - **UKG Ready employees me** (Action). Get basic information about the currently authenticated UKG Ready employee, along with links to operations providing detailed employee information. Returns: id. Required: cid. - **Update a UKG Ready employee by ID** (Update). Apply partial updates to a UKG Ready employee by id using JSON Patch. Returns: id. Accepts a JSON Patch request body. Required: id, cid. - **UKG Ready employees overwrite** (Action). Update the core employee information for a UKG Ready employee by id. Returns: id. Accepts a JSON request body with updated employee fields. Required: id, cid. - **List all UKG Ready employees info** (List). List employee information for a specific pay group in UKG Ready. Returns employee information records scoped to the specified pay group. Default limit 50, max 200 per page. Required: cid, pay_group_id. - **List all UKG Ready employee accrual balances** (List). Search through employee accrual balances in UKG Ready. Returns: acc_id, time_off_id, hours. Restricted to companies with TA or PR subsystems and Accruals functionality. Required: filter. - **Create a UKG Ready employee accrual balance** (Create). Create employee accrual balances in UKG Ready. Returns an array of accrual balance items. The hours, external_accrued, external_taken, and external_carry_over fields use HH:MM (or HH.DD) format. To set updated_to_date to end of accrual year, leave date empty and set set_to_end_of_accrual_year to true. - **UKG Ready employee accrual balances bulk update** (Update). Update employee accrual balances in UKG Ready. Returns an array of accrual balance items. The hours, external_accrued, external_taken, and external_carry_over fields use HH:MM (or HH.DD) format. To set updated_to_date to end of accrual year, leave date empty and set set_to_end_of_accrual_year to true. - **List all UKG Ready employee deductions** (List). List scheduled deductions for an employee in UKG Ready. Returns: id. Required: cid, employee_id. - **Get single UKG Ready employee deduction by ID** (Get). Get a single employee scheduled deduction by id in UKG Ready. Returns: id. Required: id, cid, employee_id. - **Create a UKG Ready employee deduction** (Create). Create a new scheduled deduction for an employee in UKG Ready. Returns: id. Required: cid, employee_id. - **Update a UKG Ready employee deduction by ID** (Update). Update an employee scheduled deduction by id in UKG Ready. Returns: id. Required: id, cid, employee_id. - **Delete a UKG Ready employee deduction by ID** (Delete). Delete an employee scheduled deduction by id in UKG Ready. Returns: id. Required: id, cid, employee_id. - **Create a UKG Ready company direct deposit** (Create). Create a new direct deposit account in UKG Ready. Returns the created direct deposit object including id, routingType, account_number, account_type, percentage, and amount. If the calculation method is GROSS_EARNING, NET_PAY, or DIRECT_DEPOSIT_PER_OF_REMAINDER, the percentage property is required; if FLAT_AMOUNT, the amount property is required. Required: cid. - **UKG Ready company direct deposits mass edit** (Action). Perform a mass edit on selected direct deposits in UKG Ready. Returns the updated direct deposit objects including id, routingType, account_number, account_type, percentage, and amount. A JSON request body specifying the selected deposits and changes is required. Required: cid. - **Get single UKG Ready company direct deposit by ID** (Get). Get a single employee direct deposit account by id in UKG Ready. Returns the direct deposit object including id, type, account_number, account_type, active_from, active_to, routingType, amount, and percentage. Required: id, cid. - **Update a UKG Ready company direct deposit by ID** (Update). Update an existing employee direct deposit account by id in UKG Ready. Returns the updated direct deposit object including id, routingType, account_number, account_type, percentage, and amount. A JSON request body with the fields to update is required. Required: id, cid. - **Delete a UKG Ready company direct deposit by ID** (Delete). Delete an existing employee direct deposit account by id in UKG Ready. Returns: id, type. Required: id, cid. - **Create a UKG Ready company contact** (Create). Create employee contacts in UKG Ready. Returns: id. The national_id_numbers field is ignored if the request includes any of the backward-compatible fields (bsn, social_insurance, social_security, national_insurance). Required: cid. - **Get single UKG Ready company contact by ID** (Get). Get a single employee contact by id in UKG Ready. Returns: id. Backward-compatible fields (bsn, social_insurance, social_security, national_insurance) are populated only if data exists; national_id_numbers is the new pattern for national identification numbers. Required: id, cid. - **Update a UKG Ready company contact by ID** (Update). Update an existing employee contact in UKG Ready. Returns: id. The national_id_numbers field is ignored if the request includes any of the backward-compatible fields. Required: id, cid. - **Delete a UKG Ready company contact by ID** (Delete). Delete an employee contact by id in UKG Ready. Returns: id. Required: id, cid. - **List all UKG Ready compensation histories** (List). List Base Compensation history entries for all subordinates in a UKG Ready company. Each item contains an id referencing a detailed compensation resource. Returns: id. Required: cid. - **Create a UKG Ready compensation history** (Create). Create an Employee Base Compensation entry in UKG Ready. The auto_pay field is processed only for companies with the Payroll subsystem. Returns: id. Required: cid. - **Get single UKG Ready compensation history by ID** (Get). Get detailed information about a specific Employee Base Compensation entry in UKG Ready. Returns: id. Required: id, cid. - **Update a UKG Ready compensation history by ID** (Update). Update an Employee Base Compensation entry in UKG Ready by id. The auto_pay field is processed only for companies with the Payroll subsystem. Returns: id. Required: id, cid. - **Delete a UKG Ready compensation history by ID** (Delete). Delete a specific Employee Base Compensation entry in UKG Ready by id. Returns: id. Required: id, cid. - **UKG Ready compensation histories list by employee** (List). List Base Compensation history entries for a specific employee in UKG Ready. Each item contains a reference to a detailed resource. Returns: id. Required: cid, employee_id. - **List all UKG Ready company timeoffs** (List). List time off categories from a company in UKG Ready. If no filter is provided, returns all time offs of the company. Returns: id, parent, visible, priority, default_counter, def_pay_category, populate_scheduled, duration. - **Create a UKG Ready company timeoff** (Create). Create time off categories in UKG Ready. Set parent to null for a root-level category; the visible property can be set only by SA users. Priority defaults to 50 if not specified. Returns: id. - **Get single UKG Ready company timeoff by ID** (Get). Get a single time off category by id in UKG Ready. Returns all time off properties including id, visible, priority, default_counter, def_pay_category, populate_scheduled, and duration, with certain fields conditionally populated based on the company's enabled functionality. Required: id. - **UKG Ready company timeoffs bulk update** (Update). Update existing time off categories in UKG Ready. A correct time off id must be provided in the body. Set parent to null to make a category root in hierarchy. Returns: id. - **UKG Ready company timeoffs bulk delete** (Delete). Delete multiple time off categories by ids in UKG Ready. Returns: id. Required: filter. - **Create a UKG Ready company employee type** (Create). Create new employee-types in UKG Ready. The name must be unique for each type. Returns: items. - **UKG Ready company employee types bulk update** (Update). Update existing employee-types in UKG Ready. Existing types can be referenced by either id or name; to change the name of a type, the id must be specified. Returns: items. - **List all UKG Ready company pay period profiles** (List). List pay period profiles in UKG Ready. Returns: pay_period_profiles. If no filter is provided, all profiles for the authenticated company are returned. Use the filter parameter with id:in: to select specific profiles by id. - **Create a UKG Ready company pay period profile** (Create). Create pay period profiles in UKG Ready. Returns: items. Set auto_lock_pp to -1 to disable Auto Lock Pay Period; otherwise set the number of days after period end. Use -1 for day of month or week number to select Last. - **UKG Ready company pay period profiles bulk update** (Update). Update existing pay period profiles in UKG Ready. Returns: items. Provide id or name in the request body to identify the target profile — at least one is required. Set auto_lock_pp to -1 to disable Auto Lock Pay Period; otherwise set the number of days after period end. Use -1 for day of month or week number to select Last. - **UKG Ready company pay period profiles bulk delete** (Delete). Delete pay period profiles by ids in UKG Ready. Returns: items. Use the id field with the IN operator to specify which profiles to delete (e.g. id:in:111111,111113,111151). Required: filter. - **List all UKG Ready company pay types** (List). List all existing pay types in a UKG Ready company. Returns: pay_types. If no company parameter is supplied, the operation runs against the company of the current authentication token. - **Create a UKG Ready company pay type** (Create). Create pay types in a UKG Ready company. A unique name must be passed for each new pay type. Returns: items. - **UKG Ready company pay types bulk update** (Update). Update pay types in a UKG Ready company. A correct id or name must identify the pay type; to change the name itself, the id is required. Returns: items. - **UKG Ready company pay types bulk delete** (Delete). Delete multiple pay types in a UKG Ready company by ids in one call. Returns: items. Required: filter. - **Create a UKG Ready profiles holiday** (Create). Create a new holiday profile in UKG Ready. The name must be unique among holiday profiles. Returns: items. - **UKG Ready profiles holidays bulk update** (Update). Update an existing holiday profile in UKG Ready. Existing profiles can be referenced by either id or name; to update the name itself, id must be specified. Returns: items. At least one of id or name must be provided to identify the target profile. - **UKG Ready employee passwords bulk update** (Update). Update the existing password for the current logged-in user in UKG Ready. Returns: index. Requires a JSON request body with the password update details. - ...and 308 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.