Connect your AI Agents to UKG Pro HCM Recruitment & Onboarding in minutes

Available tools
list_applications
List candidate applications in UKG Pro Recruiting with pagination. Returns application status, candidate, and opportunity details. Use application IDs with get_application.
get_application
Get a single application by ID from UKG Pro Recruiting. Use list_applications to find valid application IDs.
create_application
Submit a candidate application for a job opportunity in UKG Pro Recruiting. Requires candidateid and opportunityid. Use listcandidates and listopportunities to find valid IDs.
update_application
Update the status or stage of an application in UKG Pro Recruiting. Use listapplications to find valid applicationid and listrecruitingprocesses to find stage IDs.
list_candidates
List candidates in UKG Pro Recruiting with pagination. Returns candidate profiles including names and contact info. Use candidate IDs with get_candidate.
get_candidate
Get a single candidate by ID from UKG Pro Recruiting. Use list_candidates to find valid candidate IDs.
lookup_candidate
Look up a candidate by email address in UKG Pro Recruiting. Returns the candidate ID if a match is found. Use before create_candidate to check for duplicates.
create_candidate
Create a new candidate in UKG Pro Recruiting. Requires firstname, lastname, and email. Use lookup_candidate first to avoid duplicates.
update_candidate
Update an existing candidate's profile in UKG Pro Recruiting. Use listcandidates or lookupcandidate to find the candidate_id before updating.
list_offers
List job offers in UKG Pro Recruiting with pagination. Returns offer status and associated application details. Use offer IDs with get_offer.
get_offer
Get a single job offer by ID from UKG Pro Recruiting. Use list_offers to find valid offer IDs.
create_offer
Create a job offer for an applicant in UKG Pro Recruiting. Requires an applicationid. Use listapplications to find valid IDs. Optionally specify start_date, salary, and currency.
update_offer
Update a job offer in UKG Pro Recruiting (e.g. accept, decline, or rescind). Use listoffers to find the offerid and current values before updating.
list_new_hires_in_progress
List new hires currently in progress in UKG Pro Onboarding. Returns new hire IDs, names, hire dates, and onboarding status. Use new hire IDs with getnewhire.
list_new_hires_completed
List completed new hires in UKG Pro Onboarding. Returns new hire records that have finished the onboarding process.
get_new_hire
Get a single new hire record by ID from UKG Pro Onboarding. Returns full onboarding details including job, compensation, and status. Use listnewhiresinprogress to find valid IDs.
create_new_hire
Create a new hire record in UKG Pro Onboarding to start the onboarding process. Requires firstname, lastname, emailaddress, and onboardingownerid. Job and componentcompany_code must be provided together if either is supplied.
delete_new_hire
Delete (cancel) a new hire record in UKG Pro Onboarding. This cancels the onboarding process for the new hire. Use listnewhiresinprogress to find valid new hire IDs.
list_opportunities
List job opportunities (open requisitions) in UKG Pro Recruiting with pagination. Supports filtering by updatedafter and updatedbefore dates. Use opportunity IDs with get_opportunity.
get_opportunity
Get a single job opportunity by ID from UKG Pro Recruiting. Use list_opportunities to find valid opportunity IDs.
create_opportunity
Create a new job opportunity (job posting/requisition) in UKG Pro Recruiting. Requires a title. Use listrecruitingprocesses for recruitingprocessid.
update_opportunity
Update an existing job opportunity in UKG Pro Recruiting. Use listopportunities to find valid opportunityid and current field values. Can update status, title, closing date, and more.
list_recruiting_processes
List recruiting process templates in UKG Pro Recruiting. Returns process names and stage definitions used to track candidate progress. Use process IDs with getrecruitingprocess.
get_recruiting_process
Get a single recruiting process template by ID from UKG Pro Recruiting. Use listrecruitingprocesses to find valid process IDs.
validate_credential
Validate UKG Pro Recruiting credentials by obtaining an OAuth2 token and calling the recruiting processes endpoint. Returns success/failure with a descriptive message.

How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's UKG Pro HCM Recruitment & Onboarding MCP server
FAQs on using Merge's UKG Pro HCM Recruitment & Onboarding MCP server
What is a UKG Pro HCM Recruitment & Onboarding MCP?
It's an MCP server that gives your agents access to recruitment and onboarding data in UKG Pro HCM via callable tools. Your agents can invoke these tools to pull job requisitions, retrieve candidate records, track application status, manage onboarding task assignments, and more.
UKG doesn't offer an MCP server purpose built for UKG Pro HCM Recruitment & Onboarding, but you can use one from a third-party platform, like Merge Agent Handler.
How can I use the UKG Pro HCM Recruitment & Onboarding MCP server?
The use cases naturally depend on the agent you've built, but here are a few common ones:
- Candidate pipeline status updates: When a recruiter requests an update in Slack, an agent queries UKG Pro HCM for the candidate's current application stage and interview feedback, then posts a concise summary to the thread, eliminating the need to log into the ATS for routine status checks
- Automated onboarding task provisioning: When a candidate's offer is accepted and their record moves to the onboarding stage in UKG Pro HCM, an agent retrieves the assigned tasks, creates corresponding tickets in a project management tool, and notifies the hiring team, so nothing falls through the cracks before day one
- Requisition backfill detection: When a position is vacated in an HRIS, an agent cross-references UKG Pro HCM for any existing open requisitions tied to that role, surfaces matching candidates already in the pipeline, and alerts the hiring manager, reducing time-to-fill on backfills
- Weekly hiring report for leadership: On a scheduled basis, an agent pulls requisition counts, application volumes, and stage-by-stage conversion data from UKG Pro HCM and delivers a structured digest to an HR leadership Slack channel, giving executives a current view without custom reporting runs
What are popular tools for UKG Pro HCM Recruitment & Onboarding's MCP server?
Here are some of the most commonly used tools:
list_job_requisitions: returns open and closed job requisitions including role, department, hiring manager, and status. Useful for agents that need to match candidates to open roles or report on hiring pipeline health across the organization
list_candidates: retrieves candidate records with contact details, application history, and current stage. Call this when an agent needs a full view of who is in the pipeline before generating a recruiter summary or routing a follow-up action
get_candidate: fetches a single candidate's complete profile, including application data, interview notes, and hiring status. Use this when an agent needs precise details about one candidate rather than a broad pipeline pull
list_onboarding_tasks: returns the onboarding task checklist assigned to a new hire, including completion status and due dates. Helpful when an agent needs to surface outstanding items or trigger downstream provisioning steps in another system
update_application_status: moves a candidate's application to a specified stage within the hiring workflow. Good for workflows that automate stage transitions after a defined event, such as a completed background check or a signed offer letter
list_interview_schedules: pulls scheduled interviews tied to a candidate or requisition, including interviewers, times, and formats. Call this when an agent needs to send reminders, detect scheduling conflicts, or compile feedback collection prompts
What makes Merge Agent Handler's UKG Pro HCM Recruitment & Onboarding MCP server better than alternative UKG Pro HCM Recruitment & Onboarding MCP servers?
Choosing Merge Agent Handler for UKG Pro HCM Recruitment & Onboarding gives you several advantages over building a custom integration or using a less structured alternative:
- Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For UKG Pro HCM Recruitment & Onboarding, this means you can prevent candidate personal information, background check results, or compensation offers from being exposed to agents that only need application stage data
- Managed authentication and credentials: Merge stores and refreshes your UKG Pro HCM credentials on your behalf. You never hand raw API keys or OAuth tokens to an agent or take on the burden of managing credential rotation as tokens expire
- Real-time observability and audit trail: Every tool call against UKG Pro HCM Recruitment & Onboarding is logged with timestamp, tool name, input parameters, and response metadata. You can verify exactly which candidate records an agent read or which application statuses it updated, with no custom logging required
- Tool Packs and controlled access: Tool Packs let you combine specific UKG Pro HCM tools with tools from other connectors into a single scoped MCP endpoint. A recruiter-facing agent gets access to requisitions and candidate records. It has no path to compensation data or other fields outside its defined scope
How can I start using Merge Agent Handler's UKG Pro HCM Recruitment & Onboarding MCP server?
You can take the following steps (assuming you use Claude Code):
1. Create or log into your Merge Agent Handler account.
2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.
3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.
4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose UKG Pro HCM Recruitment & Onboarding and complete the auth flow. Merge stores and manages the credentials going forward.
5. Open a Claude Code session and start querying UKG Pro HCM Recruitment & Onboarding data directly. The first time you use a UKG Pro HCM tool, a Magic Link may appear to complete connector authentication.
If you want to connect Merge Agent Handler's UKG Pro HCM Recruitment & Onboarding MCP with internal or customer-facing agentic products, you can follow the steps in our docs.
Can employees use Merge Agent Handler to connect their AI tools to UKG Pro HCM Recruitment & Onboarding?
Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to UKG Pro HCM Recruitment & Onboarding without bypassing IT governance.
Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity. A recruiter can ask their AI to pull up a candidate's application history, check where they are in the pipeline, or surface upcoming interviews, all within the permissions IT has defined.
IT also provisions access by role or group via SCIM. A recruiter, for example, gets UKG Pro HCM Recruitment & Onboarding access to manage candidates and requisitions, LinkedIn to source new applicants, and Slack to coordinate with hiring managers; while an HR onboarding specialist gets UKG Pro HCM Recruitment & Onboarding access to track onboarding task completion, Workday to set up employee profiles, and Gmail to send new hire communications.
Every tool call an employee's AI makes to UKG Pro HCM Recruitment & Onboarding is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
























