Skip to content
MCP server

PaySpace MCP by usefulapi

Read PaySpace employees, organization, payroll runs, payslips and leave records…

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://payspace.usefulapi.io/mcp
Install 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