MCP server
PaySpace MCP by usefulapi
Read PaySpace employees, organization, payroll runs, payslips and leave records…
- Runs
- Remotely
- Version
- 1.18.0
- Listing updated
- 4 days ago
About PaySpace MCP by usefulapi
PaySpace MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read PaySpace employees, organization, payroll runs, payslips and leave records. Read-only.
Install
Run in a terminal
claude mcp add --transport http payspace https://payspace.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://payspace.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"payspace": {
"url": "https://payspace.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"payspace": {
"type": "http",
"url": "https://payspace.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"payspace": {
"serverUrl": "https://payspace.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"payspace": {
"type": "http",
"url": "https://payspace.usefulapi.io/mcp"
}
}
}Tools this server provides (21)
Read directly from the server.
- payspace_list_companies
- List the companies (id, code, name, group) the API credentials can access. Company ids go into the company_id argument of the other tools. From the token reply of POST /connect/token.
- payspace_list_employees
- List active employees of a company with their biographical details (name, employee number, contact, dates). Personal data. GET /odata/v2.0/{company}/Employee. Use payspace_list_all_employees to include terminated employees.
- payspace_list_all_employees
- List all employees of a company including terminated ones. Personal data. GET /odata/v2.0/{company}/Employee/all.
- payspace_get_employee
- Get one employee's biographical record by EmployeeId (the numeric id from payspace_list_employees). Personal data. GET /odata/v2.0/{company}/Employee({id}).
- payspace_list_employee_positions
- List employee position records (job, organization unit, grade, manager, effective dates). GET /odata/v2.0/{company}/EmployeePosition.
- payspace_list_employment_statuses
- List employee employment status records (hire, termination, reason, dates). GET /odata/v2.0/{company}/EmployeeEmploymentStatus.
- payspace_list_suspensions
- List employee suspension records. GET /odata/v2.0/{company}/EmployeeSuspension.
- payspace_list_organization_units
- List the organization hierarchy units (departments, divisions, cost centres) of a company. GET /odata/v2.0/{company}/OrganizationUnit.
- payspace_list_organization_positions
- List the organization positions (position details) defined for a company. GET /odata/v2.0/{company}/OrganizationPositionDetail.
- payspace_list_jobs
- List the jobs defined in job management for a company. GET /odata/v2.0/{company}/JobManagement.
- payspace_list_regions
- List the company's regions. GET /odata/v2.0/{company}/CompanyRegion.
- payspace_list_payroll_frequencies
- List the payroll frequencies of a company (the CompanyFrequency lookup). A value goes into the frequency argument of payspace_list_payroll_components, payspace_list_payroll_runs and payspace_list_recurring_components. GET /odata/v2.0/{company}/Lookup/CompanyFrequency.
- payspace_list_payroll_runs
- List the payroll runs (periods) of a company for one frequency (the CompanyRun lookup). A value goes into the period argument of payspace_list_payroll_components and payspace_list_recurring_components. GET /odata/v2.0/{company}/Lookup/CompanyRun?frequency=.
- payspace_list_payroll_components
- List the company's payroll components (earnings, deductions, contributions) with their codes, for one payroll frequency and run. Get frequency from payspace_list_payroll_frequencies and period from payspace_list_payroll_runs. GET /odata/v2.0/{company}/ComponentCompany?frequency=&period=.
- payspace_list_recurring_components
- List the recurring payroll components (EmployeeComponent) or loans (EmployeeLoan) of ONE employee for a payroll frequency and run. Personal data (pay). Get frequency from payspace_list_payroll_frequencies and period from payspace_list_payroll_runs. GET /odata/v2.0/{company}/{entity}?frequency=&period=&$filter=EmployeeNumber eq '...'.
- payspace_list_payslips
- List employee payslips (totals per employee) for a calendar year and month. Personal data (pay). GET /odata/v2.0/{company}/EmployeePayslip/{year}/{month}.
- payspace_list_payslip_lines
- List the payslip lines (one per component per employee: code, description, amount) for a calendar year and month. Personal data (pay). GET /odata/v2.0/{company}/EmployeePayslipLine/{year}/{month}.
- payspace_list_leave_applications
- List employee leave applications (type, dates, days, status). Give year and month together to restrict to a period. Personal data (absence). GET /odata/v2.0/{company}/EmployeeLeaveApplication[/{year}/{month}].
- payspace_list_leave_adjustments
- List employee leave adjustments (manual changes to leave balances). Personal data. GET /odata/v2.0/{company}/EmployeeLeaveAdjustment.
- payspace_list_leave_entitlements
- List employee leave setup entitlements (leave type, days per cycle). GET /odata/v2.0/{company}/EmployeeLeaveSetupEntitlement.
- payspace_list_records
- List records of another read-only entity set: CompanyEmploymentCategory, CompanyEmploymentSubCategory, CompanyLeaveReason, CompanyPositionFamily, CompanyPositionFunctionArea, CompanyTrainingCourse, CompanyQualification, CostingProjectActivity, OrganizationGrade, EmployeeAsset, EmployeeClaim, EmployeeDependant, EmployeeIncident, EmployeePayRate, EmployeeProject, EmployeeQualification, EmployeeSkill
PaySpace MCP by usefulapi FAQ
How do I add PaySpace MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http payspace https://payspace.usefulapi.io/mcp