Rotageek MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read staff, locations, shifts, gaps and leave; create leave requests in Rotageek.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted Rotageek connector that lets an assistant read staff, locations, shifts, rota gaps, leave and timesheets, and create leave requests.

What you can do
  • List and look up staff users and locations, including users assigned to a location
  • Read a user's or a location's scheduled shifts and leave records over a date range
  • List open gaps (unfilled shifts) across one or more locations
  • List leave requests and leave types, and create a leave request for a user
  • Get a location's weekly timesheet with scheduled and worked hours per user
  • List reference data: positions, skills and payroll codes
When to use it
Useful when you want to ask scheduling questions in plain language, such as who is working at a site next week, who is on leave, or which shifts are still unfilled, and when you occasionally need to file a leave request without opening Rotageek.
Requirements
Remote MCP endpoint connected by URL only; no local install. Sign-in uses OAuth, and the login page asks for a Rotageek API username and API user password that a Rotageek admin or Customer Success sets up. No API key or Authorization header goes in the client config. A free plan allows 50 tool calls per month; paid plans raise the limit.
Before you install
Creating a leave request writes to Rotageek and can change the rota and holiday balance, so confirm before running it. The server stores your Rotageek API credentials per user after validating them. Usage is metered, and upgrade tools return Stripe payment links for paid plans; cancelling Pro gives no refund for the current period. Staff names, contact details and schedules are sent to the hosted service.

Installation

In SourceWeft

  1. Open Rotageek MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Frotageek/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "rotageek-by-usefulapi": {
      "type": "http",
      "url": "https://rotageek.usefulapi.io/mcp"
    }
  }
}

README

Rotageek MCP by usefulapi

Use your Rotageek account from Claude, Cursor, or any MCP client. It reads staff, locations, schedules, open gaps, leave, timesheets and reference data, and it can create a leave request. Hosted, no local install: connect with your own credentials.

Live endpoint: https://rotageek.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://rotageek.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http rotageek https://rotageek.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "rotageek": {      "url": "https://rotageek.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Rotageek credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/rotageek/

On first connect you provide the Rotageek API username and API user password (your Rotageek admin creates the API user, or Rotageek Customer Success sets one up). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
rotageek_list_usersreadList users
rotageek_get_userreadGet a user
rotageek_list_locationsreadList locations
rotageek_get_locationreadGet a location
rotageek_list_location_usersreadList users at a location
rotageek_list_user_shiftsreadList a user's schedule
rotageek_list_location_schedulereadList a location's schedule
rotageek_list_gapsreadList open gaps
rotageek_list_leave_requestsreadList leave requests
rotageek_list_leave_typesreadList leave types
rotageek_create_leave_requestwriteCreate a leave request
rotageek_get_timesheetreadGet a week's timesheet
rotageek_list_positionsreadList positions
rotageek_list_skillsreadList skills
rotageek_list_payroll_codesreadList payroll codes
rotageek_usage_statusmetaUsage status (free-tier meter)
rotageek_request_featuremetaRequest a missing feature
rotageek_upgrademetaUpgrade to Pro or Pro+
rotageek_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with rotageek_upgrade (it returns a Stripe Checkout link). Cancel any time with rotageek_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running rotageek_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/rotageek/README.md at commit 4046075

Tools

15

rotageek_list_users

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.

Parameterspagesortorderuser_idspage_sizelocation_id

rotageek_get_user

Get a user

Get one user by id: name, contact details, primary location and status. Rotageek API: GET /api/v1/users/{userId}.

Parametersuser_idrequired

rotageek_list_locations

List locations

List the locations (sites) of the organisation. Rotageek API: GET /api/v1/locations.

Parameterspagesortorderpage_size

rotageek_get_location

Get a location

Get one location by id, with its settings. Rotageek API: GET /api/v1/locations/{locationId}.

Parameterslocation_idrequired

rotageek_list_location_users

List users at a location

List the users assigned to one location. Rotageek API: GET /api/v1/locations/{locationId}/users.

Parameterspagepage_sizelocation_idrequired

rotageek_list_user_shifts

List a user's schedule

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

Parameterstofrompagesortorderuser_idrequiredpage_sizerecord_type

rotageek_list_location_schedule

List a location's 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}.

Parameterstofrompagesortorderpage_sizelocation_idrequiredrecord_type

rotageek_list_gaps

List open gaps

List the open gaps (unfilled shifts) for one or more locations between two date-times. Rotageek API: GET /api/v1/gaps/locations.

Parameterstofrompagesortorderadd_taskspage_sizelocation_idsrequired

rotageek_list_leave_requests

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.

Parameterstofrompagesortorderpage_sizeleave_yearinclude_overlapping

rotageek_list_leave_types

List leave types

List the leave types (for example holiday or sickness) and their ids. Rotageek API: GET /api/v1/leave/types.

Takes no parameters.

rotageek_create_leave_request

Create a 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}.

Parametersendrequirednotesstartrequireduser_idrequiredend_all_dayleave_type_idrequiredstart_all_day

rotageek_get_timesheet

Get a week's 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}.

Parameterslocation_idrequiredworker_typeweek_start_daterequired

rotageek_list_positions

List positions

List the job positions (roles) of the organisation with their ids. Rotageek API: GET /api/v1/positions.

Takes no parameters.

rotageek_list_skills

List skills

List the skills of the organisation with their ids. Rotageek API: GET /api/v1/skills.

Takes no parameters.

rotageek_list_payroll_codes

List payroll codes

List the payroll codes that shifts and leave map to. Rotageek API: GET /api/v1/payrollcodes.

Takes no parameters.

Version history

7
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026