Merge Unified's SAP SuccessFactors integration Merge Agent Handler's SAP SuccessFactors MCP server

Connect your AI Agents to SAP SuccessFactors in minutes

Merge lets you securely connect your agents to SAP SuccessFactors and thousands of tools instantly

Start building for free

Read docs

SAP SuccessFactors

Learn more about Merge Agent Handler

Available tools

get_employee_compensation

Retrieve compensation records for an employee from SAP SuccessFactors Employee Central Compensation. Returns detailed compensation information including salary, pay grade, pay group, pay frequency, pay components, and effective dates. Essential for compensation analysis, salary verification, pay equity audits, and employee compensation inquiries.

list_employee_compensation

Retrieve a paginated list of all employee compensation records from SAP SuccessFactors Employee Central Compensation. Returns compensation information for multiple employees including salaries, pay grades, pay groups, and effective dates. Useful for bulk compensation reporting, salary benchmarking, pay equity analysis, and organizational compensation planning.

get_goal

Retrieve detailed performance goal information from SAP SuccessFactors Performance & Goals by goal ID. Returns goal data including objectives, metrics, targets, current progress, and completion status. Essential for performance management, goal tracking, and employee development discussions.

list_goals

Retrieve a paginated list of performance goals from SAP SuccessFactors Performance & Goals with OData filtering. Returns goals by user, status, category, or date range. Essential for performance reporting, goal management, employee reviews, and organizational objective tracking. Note: Goal entity name varies by instance configuration (Goal1, Goal2, Goal_9). If you encounter 'Entity not found' errors, check Admin Center > OData API Data Dictionary for your specific Goal entity name.

create_goal

Create a new performance goal in SAP SuccessFactors Performance & Goals. Requires goal name and owner user ID with optional description, category, dates, metrics, and target values. Essential for establishing performance objectives, development plans, and organizational goals.

update_goal

Update performance goal information in SAP SuccessFactors Performance & Goals. Modifies goal details, progress metrics, actual values, and completion percentages. Essential for tracking goal progress, updating targets, and facilitating performance discussions.

delete_goal

Delete a performance goal from SAP SuccessFactors Performance & Goals. Permanently removes the goal record from the system. Use with caution as deletion is irreversible. Consider updating status to cancelled instead to maintain performance history and audit trails.

get_payment_information

Retrieve payment and bank account information for an employee from SAP SuccessFactors. Returns comprehensive banking details including account holder, account type, bank name, account number, routing number, IBAN, SWIFT code, and primary account indicator. Essential for payroll processing, direct deposit setup, and financial data management.

list_payment_information

Retrieve a paginated list of all payment and bank account records from SAP SuccessFactors. Returns banking details for multiple employees including account information, routing numbers, and IBAN/SWIFT codes. Useful for bulk payroll operations, banking audits, and financial reporting.

get_payroll_results

Retrieve payroll run results for an employee from SAP SuccessFactors Payroll. Returns detailed payroll information including pay period dates, payment date, gross pay, net pay, and currency. Essential for payroll verification, employee pay stub access, compensation analysis, and payroll reporting.

list_payroll_results

Retrieve a paginated list of all payroll run results from SAP SuccessFactors Payroll. Returns payroll information for multiple employees including pay periods, payment dates, gross/net pay amounts, and currency. Useful for bulk payroll reporting, financial analysis, and payroll auditing.

get_person

Retrieve core personal information for an employee from SAP SuccessFactors by person ID. Returns comprehensive personal data including name, date of birth, gender, marital status, nationality, and preferred language. Essential for HR data management, compliance reporting, and employee profile access.

get_person_emails

Retrieve all email addresses for an employee from SAP SuccessFactors Personal Information. Returns a list of email addresses with type (personal, work) and primary indicator. Essential for employee communications, contact information management, and system integration.

get_person_phones

Retrieve all phone numbers for an employee from SAP SuccessFactors Personal Information. Returns a list of phone numbers with type (cell, home, work), country code, and primary indicator. Essential for employee contact management, emergency communications, and compliance.

get_person_addresses

Retrieve all addresses for an employee from SAP SuccessFactors Personal Information. Returns a list of addresses with type (home, work, mailing) including street address, city, state, zip code, and country. Essential for employee location data, mailing operations, tax compliance, and payroll processing.

get_emergency_contacts

Retrieve all emergency contacts for an employee from SAP SuccessFactors Personal Information. Returns a list of emergency contacts with name, relationship, phone, email, address, and primary indicator. Critical for workplace safety, emergency response procedures, and employee welfare compliance.

list_persons

Retrieve a paginated list of all persons (employees) from SAP SuccessFactors Personal Information. Returns basic personal data for multiple employees including names, IDs, and core demographics. Essential for bulk employee data queries, reporting, and system integration operations.

get_position

Retrieve detailed information about a specific organizational position from SAP SuccessFactors Position Management by position code. Returns comprehensive position data including name, effective dates, department, division, location, company, job code, business unit, incumbent, and criticality. Essential for organizational structure analysis, workforce planning, and position management.

list_positions

Retrieve paginated organizational positions from SAP SuccessFactors Position Management with filtering by department, location, company, job code, or occupancy status. Essential for organizational reporting, headcount analysis, vacancy tracking, workforce planning, and identifying positions available for recruitment or internal mobility.

list_companies

Retrieve paginated companies from SAP SuccessFactors Foundation Objects. Companies represent highest-level organizational entities. Returns company records with names, codes, status, and effective dates. Essential for multi-entity reporting, organizational structure analysis, and understanding corporate hierarchy across legal entities or business units.

get_company

Retrieve detailed company information from SAP SuccessFactors Foundation Objects by external code. Returns company data including name, status, effective dates, and organizational details. Companies represent legal entities or major business units. Essential for understanding corporate structure, compliance reporting, and organizational configuration.

list_departments

Retrieve paginated departments from SAP SuccessFactors Foundation Objects. Departments are functional organizational units within companies and key components of organizational hierarchy. Returns department records with names, codes, status, effective dates, and department heads. Essential for organizational reporting, headcount analysis, and workforce planning.

get_department

Retrieve detailed department information from SAP SuccessFactors Foundation Objects by external code. Returns department data including name, status, effective dates, and department head information. Departments are functional units structuring the workforce by responsibility area. Essential for organizational structure, reporting relationships, and department analytics.

get_job_requisition

Retrieve detailed job requisition information from SAP SuccessFactors Recruiting by requisition ID. Returns comprehensive requisition data including position details, hiring team, organizational placement, and recruitment status. Essential for recruitment management and hiring operations.

list_job_requisitions

Retrieve a paginated list of job requisitions from SAP SuccessFactors Recruiting with OData filtering. Returns requisitions by status, department, location, hiring manager, or date range. Essential for recruitment reporting, vacancy management, and talent acquisition operations.

get_employee_time

Retrieve detailed information about a specific time off/absence record from SAP SuccessFactors Time Management by external code. Returns comprehensive time record data including employee information, time type, dates, duration, approval status, and any associated comments. Essential for tracking individual absence requests and their approval workflow status.

list_employee_times

Retrieve a paginated list of employee time off/absence records from SAP SuccessFactors Time Management with filtering capabilities. This tool supports OData query parameters for filtering by user, date range, status, or time type. Essential for absence management, team planning, reporting, and analyzing time off patterns across the organization.

create_employee_time

Submit a new time off/absence record in SAP SuccessFactors Time Management for an employee. This tool initiates the absence request and approval workflow, recording the time type, dates, duration in days or hours, and optional comments. Used for vacation requests, sick leave, personal time, and other absence types. The record enters the configured approval workflow upon creation.

update_employee_time

Update an existing employee time/absence record in SAP SuccessFactors with modified details such as approval status, comments, or quantities. This tool allows modification of time off records and is essential for request management workflows including approvals, rejections, and adjustments to time off quantities.

delete_employee_time

Delete an employee time/absence record from SAP SuccessFactors. This tool permanently removes a time record and should be used with caution. Typically used for canceling erroneous records or cleaning up test data. Consider updating approval status instead of deletion for audit trail purposes.

approve_employee_time

Approve a pending employee time/absence record in SAP SuccessFactors. This tool sets the record approval status to APPROVED and optionally adds approver comments. Essential for time off approval workflows and manager self-service operations.

reject_employee_time

Reject a pending employee time/absence record in SAP SuccessFactors with a mandatory rejection reason. This tool sets the record approval status to REJECTED and records the rejection reason for audit purposes. Essential for time off approval workflows and compliance tracking.

get_time_account_balance

Retrieve time off account balances for an employee from SAP SuccessFactors Time Off. Returns all time account balances including time account type, current balance, effective start date, and booking unit (days/hours). Essential for time off planning, accrual tracking, balance verification, and employee self-service inquiries.

list_time_account_balances

Retrieve time off account balances for a specific employee from SAP SuccessFactors Time Off. Returns balance information for the employee for a specific time account type (e.g., 'VACATION', 'SICK'). Both userid and timeaccount_type are required by SAP SF API. Useful for time off reporting, accrual tracking, and balance verification.

get_user

Retrieve detailed employee information from SAP SuccessFactors Employee Central by user ID. Returns comprehensive user data including employment status, organizational assignment, job details, and personal information. Essential for employee data access, onboarding verification, and HR management operations.

list_users

Retrieve a paginated list of employees from SAP SuccessFactors Employee Central with OData filtering capabilities. Returns user records including organizational assignments, employment details, and contact information. Essential for workforce reporting, directory access, and bulk employee data queries.

create_user

Create a new employee record in SAP SuccessFactors Employee Central. Requires user ID, username, name, and email, plus optional hire date and status. Initiates the employee master record and enables access to HR systems. Essential for new hire onboarding and workforce management.

update_user

Update a SAP SuccessFactors employee's identity fields: username, first/last name, email, and status. Organizational fields (department, division, location, title, manager) are read-only on the User entity and cannot be changed here.

validate_credential

Validate SAP SuccessFactors credentials. Verifies credentials during setup.

View all tools by creating a free account See more tools

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}
11

Copy Code

Open 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}

Copy Code

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  }

Copy Code

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}