ROLLER MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 14, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only access to ROLLER venue data: search bookings, check product availability, and look up guests, waivers, gift cards and daily reports.

What you can do
  • Look up the venue, company profile, products, price rules, discounts, modifier groups, segments and resources
  • Search and read bookings, booking form answers, tickets and payments
  • Check product availability for a date or a month calendar
  • Read guest records, multi-pass balances, signed waivers and waiver form answers, and gift card balances
  • Pull daily batch reports on bookings, tickets, attendance, payments, revenue entries, memberships, guest experience scores, till reconciliations, staff and roles
  • Check usage against the plan, request a missing feature, and manage the paid subscription
When to use it
Useful for venue operators on ROLLER who want to ask an assistant about bookings, capacity and availability, guest and waiver details, or yesterday's payments and revenue without opening the back office. Also suited to pulling daily reporting exports into a conversation.
Requirements
Remote MCP endpoint reached over HTTP; no local install. Sign-in uses OAuth, and on first connect you supply a ROLLER API client ID and client secret created in ROLLER Venue Manager, plus a Live or Playground environment choice. No keys go in the client config. A free plan allows 50 tool calls per month; paid plans raise the limit.
Before you install
All listed data tools are read-only, but the meta tools can start a paid subscription: roller_upgrade returns a Stripe Checkout link, and changing or cancelling a plan affects billing, with no refund for the current period. Your ROLLER API client secret is stored per user on the hosted service, and guest, waiver and payment data is sent to that third party. Reporting tools are one-day batch exports, not real-time.

Installation

In SourceWeft

  1. Open ROLLER 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%2Froller/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": {
    "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.

Source: servers/roller/README.md at commit 6d32263

Tools

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.

Takes no parameters.

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.

ParametersdatekeywordsstartTimeproductIdslocationIds

roller_get_booking

Get booking

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

ParametersbookingIdrequiredincludeDiscounts

roller_get_booking_form_responses

Get booking form responses

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

ParametersbookingIdrequired

roller_get_company

Get company

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

ParameterscompanyIdrequired

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.

ParametersproductTypeproductSubTypeproductCategory

roller_get_product_availability

Get product availability

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

ParametersdaterequiredproductIdsproductCategory

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.

ParametersmonthrequiredproductIdrequired

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.

Takes no parameters.

roller_list_segments

List guest segments

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

Takes no parameters.

roller_get_guest

Get guest

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

ParametersguestIdrequired

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.

ParametersguestIdrequired

roller_get_signed_waiver

Get signed waiver

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

ParameterssignedWaiverIdrequired

roller_get_signed_waiver_form_responses

Get signed waiver form responses

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

ParameterssignedWaiverIdrequired

roller_get_discount

Get discount

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

ParametersdiscountIdrequired

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.

ParameterskeywordsproductId

roller_get_modifier_group

Get modifier group

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

ParametersgroupIdrequired

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.

ParametersgiftCardNumberrequired

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredlocalTimespageNumberbookingReferences

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredpageSizelocalTimespageNumber

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.

ParametersdaterequiredlocalTimesbookingReference

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.

ParametersdaterequiredlocalTimesbookingReference

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.

ParametersdaterequiredlocalTimesbookingReference

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.

ParametersdaterequiredpageSizesegmentIdrequiredlocalTimespageNumber

roller_report_products

Report products

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

ParameterspageSizelocalTimespageNumberproductTypeproductSubType

roller_report_modifiers

Report modifiers

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

ParameterspageSizelocalTimespageNumber

roller_report_discounts

Report discounts

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

ParameterspageSizelocalTimespageNumber

roller_report_resources

Report resources

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

ParameterspageSizelocalTimespageNumber

roller_report_devices

Report devices

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

ParameterspageSizelocalTimespageNumber

roller_report_staff

Report staff

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

ParameterspageSizelocalTimespageNumber

roller_report_roles

Report roles

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

ParameterspageSizelocalTimespageNumber

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.

ParameterspageSizelocalTimespageNumber

roller_report_reporting_categories

Report reporting categories

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

Takes no parameters.

Version history

1
  1. v1.0.0LatestNov 14, 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 that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 14, 2026

Planerio MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Planerio connector that lets an assistant read shifts, staffing requirements, staff, employees, absences and vacation days.

Streamable HTTPWeb executable
Productivity & Workflow6 toolsNov 14, 2026

Marmin MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to Marmin UAE e-invoicing data: invoices, credit notes, UBL XML, Peppol status and business profiles.

Streamable HTTPWeb executable
Finance10 toolsNov 14, 2026

Oyster MCP by usefulapi

io.usefulapiOfficial publisher

Remote MCP server for Oyster that lets an assistant read team, time off, expense, contract and invoice data and approve or decline requests.

Streamable HTTPWeb executable
Productivity & Workflow20 toolsNov 14, 2026

Avirato MCP by usefulapi

io.usefulapiOfficial publisher

Reads Avirato hotel PMS data — reservations, availability, rates, prices and meal plans — and records cash payments on bookings.

Streamable HTTPWeb executable
Finance23 toolsNov 14, 2026