mcpField
P
PaySpace MCP by usefulapi

PaySpace MCP by usefulapi

Remote
usefulapi.ioBusiness & Marketing0Updated today

About PaySpace MCP by usefulapi

PaySpace MCP by usefulapi is a hosted, read-only server for people who need to query PaySpace HR and payroll data from MCP clients. It covers employee, organization, payroll, payslip, and leave records and uses OAuth sign-in with the user’s PaySpace API credentials.

Key features

  1. 01List and retrieve employee records
  2. 02Inspect organization units, roles, and jobs
  3. 03Query payroll runs and components
  4. 04Retrieve monthly payslips and line items
  5. 05Review leave applications and entitlements

Use cases

  1. 01Check an employee’s employment status and positions
  2. 02Review payroll runs and payslip details
  3. 03Look up leave applications and balances

MCP support

Exposes PaySpace data lookup tools to MCP clients through a hosted endpoint. All data tools are read-only; users authenticate with PaySpace API credentials through OAuth.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://payspace.usefulapi.io/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project 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:
{
  "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 (unlimited*)
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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.