Skip to content
MCP server

Quinyx MCP by usefulapi

Read groups, roles, employees, agreement metadata, role assignments and planned shifts.

Install
Runs
Remotely
Version
1.11.0
Listing updated
4 days ago

About Quinyx MCP by usefulapi

Quinyx MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http quinyx https://quinyx.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://quinyx.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "quinyx": {
      "url": "https://quinyx.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": {
    "quinyx": {
      "type": "http",
      "url": "https://quinyx.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "quinyx": {
      "serverUrl": "https://quinyx.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "quinyx": {
      "type": "http",
      "url": "https://quinyx.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (10)

Read directly from the server.

quinyx_list_groups
Read one bounded page of organization groups (including units/sections). Requires organization:groups:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.
quinyx_list_roles
Read one bounded page of organization roles. Requires organization:roles:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.
quinyx_list_employees
Read one bounded page of scheduling employee details. Requires hr:employees:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.
quinyx_list_agreements
Read one bounded page of agreement scheduling metadata (v3preview1). Requires hr:agreements:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.
quinyx_list_role_assignments
Read one bounded page of employee role assignments. Requires hr:role-assignments:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments.
quinyx_list_shifts
Read one bounded page of scheduled shifts. Requires schedule:shifts:read. Returns data plus opaque pagination tokens; pass pageToken for another page, no automatic crawl. Operational allowlist excludes payroll, national IDs, private contact/health information and free-text comments. beginGte/beginLte required here, at most93days apart; no writes or punches.
quinyx_get_group
Read operational group metadata by internal numeric ID or documented external reference. Requires organization:groups:read. Payroll/private fields omitted.
quinyx_get_role
Read operational role metadata by internal numeric ID or documented external reference. Requires organization:roles:read. Payroll/private fields omitted.
quinyx_get_employee
Read operational employee metadata by internal numeric ID or documented external reference. Requires hr:employees:read. Payroll/private fields omitted.
quinyx_get_agreement
Read operational agreement metadata by internal numeric ID or documented external reference. Requires hr:agreements:read. Payroll/private fields omitted. Uses documented v3preview1 agreement API.

Quinyx MCP by usefulapi FAQ

How do I add Quinyx MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http quinyx https://quinyx.usefulapi.io/mcp