Connect your AI Agents to Workday in minutes
Available tools
list_custom_object_definitions
Retrieve a comprehensive paginated list of custom object definitions with filtering capabilities including based-on object filters, instance type filters, and active status filtering. Supports up to 100 results per request with offset-based pagination. Returns detailed custom object definition information including field definitions, web service aliases, security groups, and configuration details. Handles rate limiting with automatic retry and provides detailed error handling for authentication failures and invalid filter parameters.
get_custom_object_definition
Retrieve comprehensive custom object definition details for a specific definition ID including complete field definitions, web service aliases, display names, data types, validation rules, list values, security group assignments, and configuration settings. Returns detailed definition data with all available fields from Workday Custom Objects system. Includes error handling for invalid definition IDs, unauthorized access attempts, and permission restrictions with specific error codes and messages.
list_custom_object_instances
Retrieve a comprehensive paginated list of custom object instances for a specific definition with filtering capabilities including parent object filters, effective date ranges, and active status filtering. Supports up to 100 results per request with offset-based pagination. Returns detailed custom object instance information including field values, effective dates, parent object references, and instance metadata. Handles rate limiting with automatic retry and provides detailed error handling for authentication failures and invalid filter parameters.
get_custom_object_instance
Retrieve comprehensive custom object instance details for a specific instance ID including complete field values, display values, reference values, effective dates, parent object information, and instance metadata. Returns detailed instance data with all available fields from Workday Custom Objects system. Includes error handling for invalid instance IDs, unauthorized access attempts, effective date restrictions, and permission issues with specific error codes and detailed messages.
create_custom_object_instance
Create a new custom object instance with comprehensive field values, parent object associations, effective dates, and instance configurations. Validates field definitions, data types, required fields, and parent object relationships. Returns created instance data with confirmation details and instance ID. Includes comprehensive validation for field values, data type conversions, required field checks, effective date validation, and business rule enforcement with detailed error handling for validation failures and permission issues.
update_custom_object_instance
Update existing custom object instance information including field value modifications, effective date changes, status updates, and instance configurations. Supports partial updates with field-level validation and data type enforcement. Returns updated instance data with change confirmation details. Includes comprehensive error handling for field validation failures, data type conversion issues, effective date conflicts, business rule violations, and permission restrictions with specific error codes and detailed messages.
delete_custom_object_instance
Delete a custom object instance with proper validation and business rule enforcement. Validates instance dependencies, effective date restrictions, and deletion permissions. Returns confirmation of successful deletion or detailed error information. Includes comprehensive validation for instance dependencies, cascade deletion rules, effective date restrictions, and audit trail requirements with detailed error handling for dependency conflicts, permission issues, and business rule violations.
get_business_object_custom_data
Retrieve all custom object data associated with a specific business object including all custom object instances, field values, effective dates, and configuration details. Supports filtering by custom object definition and effective date parameters. Returns comprehensive custom data with all available instances and field values from Workday Custom Objects system. Includes error handling for invalid business object references, definition filters, effective date restrictions, and permission issues with specific error codes.
update_business_object_custom_data
Update custom object data for a specific business object with comprehensive field values, effective dates, and configuration changes. Supports batch updates across multiple custom object instances with validation and business rule enforcement. Returns updated instance data with change confirmation details. Includes comprehensive validation for field values, data type conversions, effective date conflicts, business rule enforcement, and dependency checks with detailed error handling for validation failures and permission issues.
list_calculated_fields
Retrieve a comprehensive paginated list of calculated fields with filtering capabilities including based-on object filters, return type filters, and active status filtering. Supports up to 100 results per request with offset-based pagination. Returns detailed calculated field information including calculation rules, return types, base objects, and configuration details. Handles rate limiting with automatic retry and provides detailed error handling for authentication failures and invalid filter parameters.
execute_calculated_field
Execute a calculated field against a specific business object with optional effective date parameters. Processes calculation rules and returns computed values with proper data type formatting and display value generation. Returns calculated results with both raw values and display-formatted values from Workday Custom Objects calculation engine. Includes error handling for invalid calculated field references, business object compatibility issues, effective date restrictions, and calculation rule execution failures with specific error codes.
validate_custom_object_data
Validate custom object data against field definitions, data types, required fields, validation rules, and business constraints. Performs comprehensive validation including data type checking, required field validation, format validation, range checking, and business rule verification. Returns validation results with detailed error messages and warnings. Includes comprehensive validation for field definitions, data type compatibility, required field compliance, validation rule enforcement, and business constraint checking with detailed error reporting.
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 Workday MCP server
FAQs on using Merge's Workday 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
