Rotageek MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.3.4更新於 Nov 7, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流資料與分析商業與電商

概覽

AI 產生的概覽

託管式 Rotageek 連接器,讓助理讀取員工、地點、班次、排班缺口、休假與工時表,並可建立休假申請。

可以做什麼
  • 列出並查詢員工使用者與地點,包含某地點下的使用者
  • 依日期範圍讀取某使用者或某地點的排班班次與休假紀錄
  • 列出多個地點的未填補班次缺口
  • 列出休假申請與休假類型,並為使用者建立休假申請
  • 取得某地點某一週的工時表,含每人排定工時與實際工時
  • 列出基礎資料:職位、技能與薪資代碼
適用情境
適合用自然語言詢問排班狀況,例如下週某據點誰上班、誰在休假、哪些班次仍空缺;也適合偶爾需要不開啟 Rotageek 就送出休假申請的情境。
執行需求
遠端 MCP 端點,只需填寫 URL,無需本機安裝。透過 OAuth 登入,登入頁要求填寫 Rotageek API 使用者名稱與 API 使用者密碼,由 Rotageek 管理員或客戶成功團隊建立。用戶端設定中不要加入 API 金鑰或 Authorization 標頭。免費方案每月 50 次工具呼叫,付費方案可提高上限。
安裝前請注意
建立休假申請會寫入 Rotageek,可能改變排班與假期餘額,執行前應先確認。伺服器驗證後會依使用者儲存 Rotageek API 憑證。呼叫次數有計量限制,升級工具會回傳 Stripe 付款連結;取消 Pro 當期不退款。員工姓名、聯絡方式與排班資料會傳送到該託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Rotageek MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Frotageek/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:servers/rotageek/README.md,提交 4046075

工具

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.

輸入參數pagesortorderuser_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}.

輸入參數user_id必填

rotageek_list_locations

List locations

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

輸入參數pagesortorderpage_size

rotageek_get_location

Get a location

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

輸入參數location_id必填

rotageek_list_location_users

List users at a location

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

輸入參數pagepage_sizelocation_id必填

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

輸入參數tofrompagesortorderuser_id必填page_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}.

輸入參數tofrompagesortorderpage_sizelocation_id必填record_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.

輸入參數tofrompagesortorderadd_taskspage_sizelocation_ids必填

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.

輸入參數tofrompagesortorderpage_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.

無需輸入參數。

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

輸入參數end必填notesstart必填user_id必填end_all_dayleave_type_id必填start_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}.

輸入參數location_id必填worker_typeweek_start_date必填

rotageek_list_positions

List positions

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

無需輸入參數。

rotageek_list_skills

List skills

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

無需輸入參數。

rotageek_list_payroll_codes

List payroll codes

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

無需輸入參數。

版本歷史

7
  1. v1.3.4最新Nov 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合