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