# PaySpace MCP by usefulapi

> PaySpace MCP by usefulapi is an MCP server. Read PaySpace employees, organization, payroll runs, payslips and leave records. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/payspace/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/payspace
- **MCP Registry name:** io.usefulapi/payspace
- **Listing updated:** 2026-11-13

## About

Read PaySpace employees, organization, payroll runs, payslips and leave records. Read-only.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http payspace https://payspace.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://payspace.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "payspace": {
      "url": "https://payspace.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "payspace": {
      "type": "http",
      "url": "https://payspace.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "payspace": {
      "serverUrl": "https://payspace.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "payspace": {
      "type": "http",
      "url": "https://payspace.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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

## 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

---
Source: https://ai-powered.com/mcp/payspace-mcp-by-usefulapi
