Connect your AI Agents to UKG Pro in minutes
Available tools
list_companies
List company details from UKG Pro with pagination. Returns company names, IDs, addresses, and other company configuration data.
get_company
Get a specific company by ID. Returns company name, address, and configuration details. Use list_companies to find valid IDs.
list_compensation_details
List compensation details from UKG Pro with pagination. Returns salary, pay rate, pay frequency, and other compensation data for all employees.
get_compensation_details
Get compensation details for a specific employee by ID. Returns salary, pay rate, pay frequency, and other compensation data.
list_employee_demographics
List employee demographic details from UKG Pro with pagination. Returns names, addresses, contact info, and other demographic data. Use page and per_page for pagination.
get_employee_demographics
Get demographic details for a specific employee by ID. Returns name, address, contact info, and other demographic data.
list_person_details
List person details from UKG Pro with pagination. Returns personal information including date of birth, gender, ethnicity, and other person-level data.
get_person_details
Get person details for a specific employee by ID. Returns personal information including date of birth, gender, ethnicity, and other person-level data.
list_employment_details
List employment details from UKG Pro with pagination. Returns hire date, status, job title, department, and other employment data for all employees.
get_employment_details
Get employment details for a specific employee by ID. Returns hire date, status, job title, department, and other employment data.
list_job_history
List employee job history details from UKG Pro with pagination. Returns job changes, promotions, transfers, and other employment history records.
get_employee_job_history
Get job history for a specific employee by ID. Returns all job changes, promotions, transfers, and other employment history records for the employee.
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 MCP server
FAQs on using Merge's UKG Pro MCP server
Explore other MCP servers built and managed by Merge
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
