# Quinyx MCP by usefulapi

> Quinyx MCP by usefulapi is an MCP server. Read groups, roles, employees, agreement metadata, role assignments and planned shifts. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

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

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

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

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

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