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 集成