PaySpace MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.14.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted, read-only MCP server that lets an assistant read PaySpace employees, organization, payroll runs, payslips and leave records.

What you can do
  • List companies and employees, including terminated staff, and fetch one employee's record
  • List positions, employment statuses, suspensions, organization units, jobs and regions
  • List payroll frequencies, runs, company payroll components and an employee's recurring components or loans
  • List payslips and payslip lines for a given year and month
  • List leave applications, adjustments and entitlements
  • List records of other read-only entity sets, and check usage, request features, upgrade or cancel a plan
When to use it
Useful when you want to ask questions about PaySpace HR and payroll data in plain language, such as who is active in a department, what a month's payslip lines add up to, or which leave applications were filed in a period.
Requirements
Remote endpoint added by URL only; no local install. Sign-in is via OAuth, and the login page asks for a PaySpace API Client ID and Client Secret created by a company administrator. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
The server handles personal and payroll data (names, contact details, pay, absence), which is sent to a third-party host. Credentials are entered on the provider's login page and stored per user. Meta tools can start a paid Stripe subscription or cancel it, with no refund for the current period, so confirm before running them.

Installation

In SourceWeft

  1. Open PaySpace MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fpayspace/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

PaySpace MCP by usefulapi

Use PaySpace from Claude, Cursor, or any MCP client — read your employees, organization, payroll runs, payslips and leave records. Read-only. Hosted, no local install: connect with your own PaySpace API credentials.

Live endpoint: https://payspace.usefulapi.io/mcp · Homepage: https://usefulapi.io/payspace

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://payspace.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http payspace https://payspace.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "payspace": {      "url": "https://payspace.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your PaySpace credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/payspace/

On first connect you'll enter your PaySpace API Client ID and Client Secret (a company administrator creates them under Config > Basic Settings > General Company > Integrations > API Credentials). They are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
payspace_list_companiesreadList companies
payspace_list_employeesreadList employees
payspace_list_all_employeesreadList all employees (incl. terminated)
payspace_get_employeereadGet an employee
payspace_list_employee_positionsreadList employee positions
payspace_list_employment_statusesreadList employment statuses
payspace_list_suspensionsreadList employee suspensions
payspace_list_organization_unitsreadList organization units
payspace_list_organization_positionsreadList organization positions
payspace_list_jobsreadList jobs
payspace_list_regionsreadList regions
payspace_list_payroll_frequenciesreadList payroll frequencies
payspace_list_payroll_runsreadList payroll runs
payspace_list_payroll_componentsreadList payroll components
payspace_list_recurring_componentsreadList an employee's recurring components or loans
payspace_list_payslipsreadList payslips for a month
payspace_list_payslip_linesreadList payslip lines for a month
payspace_list_leave_applicationsreadList leave applications
payspace_list_leave_adjustmentsreadList leave adjustments
payspace_list_leave_entitlementsreadList leave entitlements
payspace_list_recordsreadList records of another entity
payspace_usage_statusmetaUsage status (free-tier meter)
payspace_request_featuremetaRequest a missing feature
payspace_upgrademetaUpgrade to Pro or Pro+
payspace_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per company)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with payspace_upgrade (it returns a Stripe Checkout link). Cancel any time with payspace_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running payspace_upgrade before then undoes the cancel. Or write to [email protected].

License

Source: servers/payspace/README.md at commit 4046075

Tools

21

payspace_list_companies

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.

Takes no parameters.

payspace_list_employees

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.

Parameterstopskipcountfilterselectorderbycompany_id

payspace_list_all_employees

List all employees (incl. terminated)

List all employees of a company including terminated ones. Personal data. GET /odata/v2.0/{company}/Employee/all.

Parameterstopskipcountfilterselectorderbycompany_id

payspace_get_employee

Get an 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}).

Parameterscompany_idemployee_idrequired

payspace_list_employee_positions

List employee positions

List employee position records (job, organization unit, grade, manager, effective dates). GET /odata/v2.0/{company}/EmployeePosition.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_employment_statuses

List employment statuses

List employee employment status records (hire, termination, reason, dates). GET /odata/v2.0/{company}/EmployeeEmploymentStatus.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_suspensions

List employee suspensions

List employee suspension records. GET /odata/v2.0/{company}/EmployeeSuspension.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_organization_units

List organization units

List the organization hierarchy units (departments, divisions, cost centres) of a company. GET /odata/v2.0/{company}/OrganizationUnit.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_organization_positions

List organization positions

List the organization positions (position details) defined for a company. GET /odata/v2.0/{company}/OrganizationPositionDetail.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_jobs

List jobs

List the jobs defined in job management for a company. GET /odata/v2.0/{company}/JobManagement.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_regions

List regions

List the company's regions. GET /odata/v2.0/{company}/CompanyRegion.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_payroll_frequencies

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.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_payroll_runs

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=.

Parameterstopskipcountfilterorderbyfrequencyrequiredcompany_id

payspace_list_payroll_components

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=.

Parameterstopskipcountfilterperiodrequiredorderbyfrequencyrequiredcompany_id

payspace_list_recurring_components

List an employee's recurring components or loans

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 '...'.

Parameterstopskipcountentityrequiredperiodrequiredorderbyfrequencyrequiredcompany_idemployee_numberrequired

payspace_list_payslips

List payslips for a month

List employee payslips (totals per employee) for a calendar year and month. Personal data (pay). GET /odata/v2.0/{company}/EmployeePayslip/{year}/{month}.

Parameterstopskipyearrequiredcountmonthrequiredfilterorderbycompany_id

payspace_list_payslip_lines

List payslip lines for a month

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

Parameterstopskipyearrequiredcountmonthrequiredfilterorderbycompany_id

payspace_list_leave_applications

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}].

Parameterstopskipyearcountmonthfilterorderbycompany_id

payspace_list_leave_adjustments

List leave adjustments

List employee leave adjustments (manual changes to leave balances). Personal data. GET /odata/v2.0/{company}/EmployeeLeaveAdjustment.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_leave_entitlements

List leave entitlements

List employee leave setup entitlements (leave type, days per cycle). GET /odata/v2.0/{company}/EmployeeLeaveSetupEntitlement.

Parameterstopskipcountfilterorderbycompany_id

payspace_list_records

List records of another entity

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, EmployeeOutOfOffice. GET /odata/v2.0/{company}/{entity}. Employee-level entities contain personal data.

Parameterstopskipcountentityrequiredfilterselectorderbycompany_id

Version history

12
  1. v1.14.4LatestNov 7, 2026
  2. v1.13.3Nov 5, 2026
  3. v1.13.2Nov 5, 2026
  4. v1.13.1Nov 4, 2026
  5. v1.13.0Nov 3, 2026
  6. v1.12.1Nov 3, 2026
  7. v1.11.0Nov 1, 2026
  8. v1.9.0Oct 31, 2026
  9. v1.8.0Oct 31, 2026
  10. v1.7.2Oct 30, 2026
  11. v1.7.0Oct 30, 2026
  12. v1.2.0Oct 26, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026