ROLLER MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.0.0更新于 Nov 14, 2026

Search bookings, check availability, and read guests, waivers and payments in ROLLER.

发布方自己的服务：Ably MCP by usefulapi

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

只读访问 ROLLER 场馆数据：搜索预订、查询产品可用性，并查看宾客、免责声明、礼品卡和每日报表。

可以做什么
  • 查询场馆、公司资料、产品、价格规则、折扣、附加选项组、宾客分群和资源
  • 搜索并读取预订、预订表单回答、票券和付款
  • 按日期或按月日历查询产品可用性
  • 读取宾客记录、多次通行证余额、已签免责声明及其表单回答、礼品卡余额
  • 拉取预订、票券、入场、付款、收入分录、会员、宾客体验评分、收银对账、员工和角色的每日批量报表
  • 查看套餐用量、提交缺失功能请求并管理付费订阅
适用场景
适合使用 ROLLER 的场馆运营者，让助手回答预订、容量与可用性、宾客与免责声明信息，或昨天的付款与收入，而无需打开后台。也适合把每日报表导出拉进对话中分析。
运行要求
通过 HTTP 连接的远程 MCP 端点，无需本地安装。登录使用 OAuth，首次连接时需提供在 ROLLER Venue Manager 创建的 API client ID 与 client secret，并选择 Live 或 Playground 环境。密钥不写入客户端配置。免费套餐每月 50 次工具调用，付费套餐可提高上限。
安装前请注意
所列数据工具均为只读，但元工具可能开通付费订阅：roller_upgrade 会返回 Stripe 结账链接，变更或取消套餐会影响计费，当前周期不退款。ROLLER API client secret 会按用户存储在托管服务上，宾客、免责声明和付款数据会发送给该第三方。报表工具为单日批量导出，并非实时。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ROLLER MCP by usefulapi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Froller/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

ROLLER MCP by usefulapi

Use your ROLLER account from Claude, Cursor, or any MCP client. Read bookings, products, availability, guests, waivers and payment reports. Hosted, no local install: connect with your own credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://roller.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http roller https://roller.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": {    "roller": {      "url": "https://roller.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 ROLLER credentials.

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

On first connect you provide your API client ID and API client secret, created in ROLLER Venue Manager under Settings → Integrations → API keys → Create client key, and choose Live or Playground as the Environment. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
roller_get_venuereadGet venue
roller_search_bookingsreadSearch bookings
roller_get_bookingreadGet booking
roller_get_booking_form_responsesreadGet booking form responses
roller_get_companyreadGet company
roller_list_productsreadList products
roller_get_product_availabilityreadGet product availability
roller_get_product_availability_calendarreadGet product availability calendar
roller_get_price_rulesreadGet price rules
roller_list_segmentsreadList guest segments
roller_get_guestreadGet guest
roller_get_guest_multi_passesreadGet guest multi-passes
roller_get_signed_waiverreadGet signed waiver
roller_get_signed_waiver_form_responsesreadGet signed waiver form responses
roller_get_discountreadGet discount
roller_list_modifier_groupsreadList modifier groups
roller_get_modifier_groupreadGet modifier group
roller_get_gift_card_balancereadGet gift card balance
roller_report_bookingsreadReport bookings
roller_report_ticketsreadReport tickets
roller_report_gift_cardsreadReport gift cards
roller_report_guestsreadReport guests
roller_report_attendancereadReport attendance
roller_report_signed_waiversreadReport signed waivers
roller_report_booking_signed_waiversreadReport booking signed waivers
roller_report_paymentsreadReport payments
roller_report_revenue_entriesreadReport revenue entries
roller_report_gx_scoresreadReport guest experience scores
roller_report_till_reconciliationsreadReport till reconciliations
roller_report_membership_redemptionsreadReport membership redemptions
roller_report_membership_statusesreadReport membership statuses
roller_report_membership_creditsreadReport membership credits
roller_report_guest_segment_membersreadReport guest segment members
roller_report_productsreadReport products
roller_report_modifiersreadReport modifiers
roller_report_discountsreadReport discounts
roller_report_resourcesreadReport resources
roller_report_devicesreadReport devices
roller_report_staffreadReport staff
roller_report_rolesreadReport roles
roller_report_waiversreadReport waivers
roller_report_reporting_categoriesreadReport reporting categories
roller_usage_statusmetaUsage status (free-tier meter)
roller_request_featuremetaRequest a missing feature
roller_upgrademetaUpgrade to Pro or Pro+
roller_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)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run roller_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with roller_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with roller_upgrade before then undoes the cancel. Or write to [email protected].

License

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

来源：servers/roller/README.md，提交 6d32263

工具

42

roller_get_venue

Get venue

Get the venue the API key belongs to: name, time zone, currency, country, taxes, fees and venue groups. Read only.

无需输入参数。

roller_search_bookings

Search bookings

Search the 100 most recent bookings by keywords (name, ticket id, guest name, email or phone), by booking date, by session start time, by product ids or by resource ids. At least one filter is required. Product ids and resource ids need a date. Read only.

输入参数datekeywordsstartTimeproductIdslocationIds

roller_get_booking

Get booking

Get one booking: status, guest, items, tickets, modifiers, totals and payments. Read only.

输入参数bookingId必填includeDiscounts

roller_get_booking_form_responses

Get booking form responses

Get the form questions and answers captured on a booking. Read only.

输入参数bookingId必填

roller_get_company

Get company

Get a company profile of the venue: contact, address, tax and registration numbers. Read only.

输入参数companyId必填

roller_list_products

List products

List the products of the venue with prices, dates and settings. The data changes rarely: ask for it sparingly. Read only.

输入参数productTypeproductSubTypeproductCategory

roller_get_product_availability

Get product availability

Get the products that are available on one date, with capacity and session times. Read only.

输入参数date必填productIdsproductCategory

roller_get_product_availability_calendar

Get product availability calendar

Get the availability status of each day of one month for one product: available, filling, soldOut, notAvailable or onlineSalesClosed. Read only.

输入参数month必填productId必填

roller_get_price_rules

Get price rules

List the active time-based price rules of the venue: the price tiers and when each tier applies. Read only.

无需输入参数。

roller_list_segments

List guest segments

List the guest segments set up for the venue (id and name). Read only.

无需输入参数。

roller_get_guest

Get guest

Get one guest record: name, email, phone, address, marketing consent and flags. Read only.

输入参数guestId必填

roller_get_guest_multi_passes

Get guest multi-passes

Get the multi-pass balances of one guest: uses remaining, expiry and exhaustion status. Read only.

输入参数guestId必填

roller_get_signed_waiver

Get signed waiver

Get one waiver signed by a guest: signer, validity and dates. Read only.

输入参数signedWaiverId必填

roller_get_signed_waiver_form_responses

Get signed waiver form responses

Get the form questions and answers captured on a signed waiver. Read only.

输入参数signedWaiverId必填

roller_get_discount

Get discount

Get one discount configuration: amount or percent off, products, channels, dates and usage limit. Read only.

输入参数discountId必填

roller_list_modifier_groups

List modifier groups

List the modifier groups of the venue with their modifiers. Filter by group name text or by a stock product. Read only.

输入参数keywordsproductId

roller_get_modifier_group

Get modifier group

Get one modifier group with its modifiers and linked products. Read only.

输入参数groupId必填

roller_get_gift_card_balance

Get gift card balance

Get the balance, initial value and expiry date of a gift card by its number. This sends a read request and changes nothing. Read only.

输入参数giftCardNumber必填

roller_report_bookings

Report bookings

List the bookings and their items whose booking was created or modified on one day (the filter is the booking modified date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_tickets

Report tickets

List the tickets (passes, session passes, recurring passes and memberships) of bookings that were created or modified on one day (the filter is the booking modified date, not the ticket date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_gift_cards

Report gift cards

List the gift cards created or modified on one day (the filter is the modified date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_guests

Report guests

List the guest records created or modified on one day (the filter is the modified date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_attendance

Report attendance

List the attendance records of one day: check-ins when a booking item is redeemed. Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_signed_waivers

Report signed waivers

List the signed waiver records created or modified on one day (the filter is the modified date, so an older waiver can appear when it changes). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_booking_signed_waivers

Report booking signed waivers

List which signed waivers belong to which bookings and tickets, for records created or modified on one day (the filter is the modified date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_payments

Report payments

List the payments made against bookings on one day. Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_revenue_entries

Report revenue entries

List the revenue entries of one day (funds received and recognised revenue, by entry date). The page size is fixed at 100 by ROLLER. Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填localTimespageNumberbookingReferences

roller_report_gx_scores

Report guest experience scores

List the guest experience (GX) score responses created or modified on one day (the filter is the modified date). Reporting API: one day per call (the daily batch export). Not for real-time use. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_till_reconciliations

Report till reconciliations

List the point of sale till reconciliations closed on one day. Reporting API: one day per call. Read only.

输入参数date必填pageSizelocalTimespageNumber

roller_report_membership_redemptions

Report membership redemptions

List the membership redemptions of one day, optionally for one booking. Reporting API: one day per call. Not for real-time use. Read only.

输入参数date必填localTimesbookingReference

roller_report_membership_statuses

Report membership statuses

List the membership status changes of one day, optionally for one booking. Reporting API: one day per call. Not for real-time use. Read only.

输入参数date必填localTimesbookingReference

roller_report_membership_credits

Report membership credits

List the credits issued against memberships on one day, optionally for one booking. Reporting API: one day per call. Not for real-time use. Read only.

输入参数date必填localTimesbookingReference

roller_report_guest_segment_members

Report guest segment members

List the guests whose membership of one segment changed on one day. Reporting API: one day per call. Read only.

输入参数date必填pageSizesegmentId必填localTimespageNumber

roller_report_products

Report products

List all products, parent and variation products together. Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumberproductTypeproductSubType

roller_report_modifiers

Report modifiers

List all modifiers with their group and amount. Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_discounts

Report discounts

List all discounts the venue offers (the setup, not the usage). Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_resources

Report resources

List all resources (formerly locations). Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_devices

Report devices

List the point of sale, kiosk and check-in scanner devices. Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_staff

Report staff

List the active staff accounts (name, email, role, lock status). Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_roles

Report roles

List the staff roles. Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_waivers

Report waivers

List the waiver terms and settings, active and past (not the signed waivers). Reporting API: all records, in pages. Read only.

输入参数pageSizelocalTimespageNumber

roller_report_reporting_categories

Report reporting categories

List the reporting categories with their general ledger codes and product ids. Reporting API. Read only.

无需输入参数。

版本历史

1
  1. v1.0.0最新Nov 14, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

面向 Ably 的托管 MCP 服务器，让助手查看实时频道、在线状态与用量统计、发布消息，并查看应用配置。

Streamable HTTP可网页运行
沟通与协作15 个工具Nov 14, 2026

Planerio MCP by usefulapi

io.usefulapi官方发布者

托管的 Planerio 连接器，让助手读取排班、人力需求、可用人员、员工资料、缺勤和年假天数。

Streamable HTTP可网页运行
效率与工作流6 个工具Nov 14, 2026

Marmin MCP by usefulapi

io.usefulapi官方发布者

只读访问 Marmin 的阿联酋电子发票数据：发票、贷项通知单、UBL XML、Peppol 状态与业务档案。

Streamable HTTP可网页运行
金融10 个工具Nov 14, 2026

Oyster MCP by usefulapi

io.usefulapi官方发布者

面向 Oyster 的远程 MCP 服务器，让助手读取团队、休假、报销、合同与发票数据，并审批或拒绝相关申请。

Streamable HTTP可网页运行
效率与工作流20 个工具Nov 14, 2026

Avirato MCP by usefulapi

io.usefulapi官方发布者

读取 Avirato 酒店 PMS 的预订、可用房、房价与餐标数据，并可在预订上登记现金付款。

Streamable HTTP可网页运行
金融23 个工具Nov 14, 2026