MCP server
Rotageek MCP by usefulapi
Read staff, locations, shifts, gaps and leave; create leave requests in Rotageek.
- Runs
- Remotely
- Version
- 1.7.0
- Listing updated
- 4 days ago
About Rotageek MCP by usefulapi
Rotageek 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 rotageek https://rotageek.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://rotageek.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rotageek": {
"url": "https://rotageek.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": {
"rotageek": {
"type": "http",
"url": "https://rotageek.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rotageek": {
"serverUrl": "https://rotageek.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rotageek": {
"type": "http",
"url": "https://rotageek.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- rotageek_list_users
- List the users (staff) in the organisation, optionally filtered by user ids or a location. Use it first to find the user ids the other tools need. Rotageek API: GET /api/v1/users.
- rotageek_get_user
- Get one user by id: name, contact details, primary location and status. Rotageek API: GET /api/v1/users/{userId}.
- rotageek_list_locations
- List the locations (sites) of the organisation. Rotageek API: GET /api/v1/locations.
- rotageek_get_location
- Get one location by id, with its settings. Rotageek API: GET /api/v1/locations/{locationId}.
- rotageek_list_location_users
- List the users assigned to one location. Rotageek API: GET /api/v1/locations/{locationId}/users.
- rotageek_list_user_shifts
- List the scheduled shifts and leave records of one user between two date-times, with start, end, location and break minutes. Rotageek API: GET /api/v1/schedule/users/{userId}.
- rotageek_list_location_schedule
- List the scheduled shifts and leave records of one location between two date-times, for every user there. Rotageek API: GET /api/v1/schedule/locations/{locationId}.
- rotageek_list_gaps
- List the open gaps (unfilled shifts) for one or more locations between two date-times. Rotageek API: GET /api/v1/gaps/locations.
- rotageek_list_leave_requests
- List the leave requests of the organisation, optionally in a leave year or date range. Rotageek API: GET /api/v1/leave/requests.
- rotageek_list_leave_types
- List the leave types (for example holiday or sickness) and their ids. Rotageek API: GET /api/v1/leave/types.
- rotageek_create_leave_request
- Create a leave request for one user with a leave type id and a start and end date-time. It is saved in Rotageek and can change the rota and holiday balance. Rotageek API: POST /api/v1/leave/requests/users/{userId}.
- rotageek_get_timesheet
- Get the timesheet records of one location for the week that starts on weekStartDate: hours scheduled and worked per user. Rotageek API: GET /api/v1/timesheets/locations/{locationId}/{weekStartDate}.
- rotageek_list_positions
- List the job positions (roles) of the organisation with their ids. Rotageek API: GET /api/v1/positions.
- rotageek_list_skills
- List the skills of the organisation with their ids. Rotageek API: GET /api/v1/skills.
- rotageek_list_payroll_codes
- List the payroll codes that shifts and leave map to. Rotageek API: GET /api/v1/payrollcodes.
Rotageek MCP by usefulapi FAQ
How do I add Rotageek MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http rotageek https://rotageek.usefulapi.io/mcp