RotaCloud MCP by usefulapi

Reviewed 1d ago.

• tools: 26 tools scanned
• metadata: scanned

No findings.

Tools (26)

• 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. GET /users.

• 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 state. Filter by users, locations, roles, open or published. GET /shifts.

• 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/expired requests are excluded unless asked for. GET /leave.

• 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}/payroll.

• 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_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.