io.usefulapi/rotacloud

up checked 2026-11-11T05:38:29.848Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

RotaCloud MCP by usefulapi

Publisher-provided description

Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.

Summary by lookupd

Lets agents read and manage RotaCloud rotas: shifts, attendance, leave requests, availability and payroll data for employees.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add rotacloud --url https://rotacloud.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "rotacloud": {
      "url": "https://rotacloud.usefulapi.io/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (28 tools)

Publisher-provided text

• rotacloud_list_accounts The RotaCloud account(s) this API key belongs to: name, plan, time zone, employee count. GET /accounts.
• rotacloud_list_users List employees (users) with their level, roles, locations, contact details and pay settings. Use it to map user ids in shifts, leave and attendance to names. GE
• rotacloud_get_user One employee by id. GET /users/{id}.
• rotacloud_list_locations List locations (sites/branches) with address, time zone and managers. GET /locations.
• rotacloud_list_roles List job roles (positions) with colour, default break and pay rate. GET /roles.
• rotacloud_list_shifts List rota shifts in a time range: start/end times (Unix seconds), break, assigned user (null = open shift), location, role, notes, published and acknowledged st
• rotacloud_get_shift One shift by id. GET /shifts/{id}.
• rotacloud_list_swap_requests List shift swap requests with their status, the shifts and the users involved. GET /swap_requests.
• rotacloud_list_day_notes List day notes (notices pinned to rota dates, e.g. events or deliveries), optionally for one location. GET /day_notes.
• rotacloud_list_attendance List time & attendance records (clock-in/out times, breaks, minutes late, hours, approval state) in a time range. GET /attendance.
• rotacloud_list_clocked_in Who is clocked in right now: user, location, role, clock-in time, minutes late and break state. GET /users_clocked_in.
• rotacloud_list_leave List booked leave (holiday, sickness, etc.) with type, user, dates, hours and status. Filter by date range or leave year, users and leave types; pending/denied/
• rotacloud_list_leave_requests List leave requests awaiting a decision (and past ones): user, leave type, dates, half days, the employee's message. GET /leave_requests.
• rotacloud_get_leave_request One leave request by id, with the per-day breakdown. GET /leave_requests/{id}.
• rotacloud_list_leave_types List leave types (Holiday, Sickness, Unpaid, ...) with id, short name and whether employees can request them. GET /leave_types.
• rotacloud_list_holiday_allowances Every employee's holiday allowance for a leave year (default and custom allowance, unit, carried over). GET /holiday_allowances/{year}.
• rotacloud_get_availability Employees' availability per date in a range (available / unavailable times). GET /availability.
• rotacloud_list_days_off Employees' scheduled days off per date in a range. GET /days_off.
• rotacloud_list_pay_periods List pay periods overlapping a date range (id, name, start/end date, locked). GET /pay_periods.
• rotacloud_get_payroll Payroll for one pay period, per employee: pay settings, attendance worked, paid/unpaid leave, overtime and pay totals. Contains pay data. GET /pay_periods/{id}/
• rotacloud_create_shift WRITE: create a shift on the rota. Leave user_id out for an open shift. Unpublished by default (employees see it once published). POST /shifts.
• rotacloud_update_shift WRITE: change a shift's times, assignee, location, role, break, notes or published state. Only the fields you pass change. POST /shifts/{id}.
• rotacloud_publish_shifts WRITE: publish shifts so the assigned employees see them (and get notified). POST /shifts_published.
• rotacloud_find_shifts Find shifts in a time range by open/assigned state, published state, location, role and ELAPSED duration (end − start; the break is not subtracted). It reads pa
• rotacloud_delete_shifts WRITE — deletes shifts from the rota (assigned employees lose the shift). Delete 1-100 shifts by id; select them first with rotacloud_find_shifts. Without confi
• rotacloud_create_leave_request WRITE: submit a leave request on behalf of an employee (sent as that user, for a manager to approve). POST /leave_requests with the User header.
• rotacloud_approve_leave_request WRITE: approve a pending leave request (it becomes booked leave and the employee is notified). POST /leave_requests/{id}/approve.
• rotacloud_deny_leave_request WRITE: deny a pending leave request (the employee is notified). POST /leave_requests/{id}/deny.

Details

• Version: 1.29.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 690 ms
• First indexed: 2026-11-01T10:05:58.728Z
• Last seen in registry: 2026-11-11T00:17:32.685Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/rotacloud/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/rotacloud.svg)](https://lookupd.com/servers/io.usefulapi/rotacloud)

• 62033 servers
• Last crawl: 2026-11-11T15:38:39.561Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp