Cluby MCP
Server Details
Cluby MCP allows you to manage your restaurant, loyalty program and events from your favorite AI chat.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- Cluby
TDQS
Scored across 35 tools
Almost every tool targets a distinct resource+action, and the descriptions spend real effort disambiguating near-neighbours (e.g. test_webhook_endpoint vs test_smart_link_webhook, search_pos_articles vs test_article_search, set_pos_connection vs get_pos_connection). The main soft spots are three analytics tools (dashboard_summary, member_stats, org_activity) whose boundaries an agent must infer, and the pair of webhook test tools that differ only by whether a link exists.
Overwhelmingly consistent snake_case verb_noun (create_/update_/delete_/list_/get_/set_/test_/replay_/link_/import_/search_). The deviations are minor: three read-only tools are bare nouns (dashboard_summary, member_stats, org_activity), and connection lifecycle uses 'set_pos_connection' for create-or-update while delete is 'delete_pos_connection'.
35 tools is heavy, but the surface genuinely spans several independent sub-domains (benefits/gifts CRUD, smart links + NFC cards, webhook endpoints/log/replay, POS connection, analytics), and no tool looks redundant. Still, it is well past the comfortable range and forces agents to scan a long list before finding the right tool.
Read coverage is excellent (list_* for orgs, venues, benefits, gifts, links, cards, endpoints, log, activity, stats) and write coverage is solid for benefits, gifts, links, endpoints and POS. However there is no delete_benefit, delete_birthday_gift or delete_smart_link — lifecycle stops at update with status=hidden — and no single-resource get_* fetches beyond get_pos_connection, so some obvious operations are missing.
Available Tools
35 toolscreate_benefitCreate benefitAInspect
Create a benefit (member perk), the same as saving the Partner Hub's benefit form. An independent copy is created in each venue of venueIds (public ids from list_venues) and the response lists every copy. Requires the admin role on those venues. For a new photo, call import_image first and pass its image as content.image. Text fields are localized strings: { default: "…" } plus optional per-locale translations such as fi or en. activation needs validFrom (ISO datetime; the current time for a benefit available right away), validUntil (null for no end date) and frequency (how often one member can activate it). visibleToStatusCards (ids from list_status_cards) limits it to holders of those membership cards; omit it for every member. For a benefit created from the partner product catalogue (productVariantId), materialsOrder gives the shipping contact's name, email and phone for the free marketing materials sent to the venue. The benefit is live for members at once unless status is hidden, so confirm the details with the user before calling this.
Inputs: content (required), venueIds (required), activation (required), orgId, +7 more.
create_birthday_giftCreate birthday giftAInspect
Create a birthday gift, the same as saving the Partner Hub's birthday gift form. It applies to every venue of venueIds (public ids from list_venues). Requires the admin role on those venues. For a new photo, call import_image first and use its originalUrl as content.imageUrl (and the photo credit in image.attribution, if any, as content.imageAttribution). content.name and content.description are localized strings: { default: "…" } plus optional per-locale translations such as fi or en. options.expirationDays is how long a member has to use the gift and options.advanceSendDays how many days before the birthday it is delivered. Unless status is hidden, members receive the gift around their birthday, as options.advanceSendDays sets, so confirm the details with the user before calling this.
Inputs: content (required), message (required), options (required), venueIds (required), +3 more.
create_smart_linkCreate smart linkAInspect
Create a smart link; the response carries its public url (cluby.app/). Requires the admin role. name is optional and defaults to a label built from the action and target. action is what the link does when scanned: join (member joins the venue; target venue::<venueId>), show (opens the venue or a benefit; target venue::<venueId> or org::<orgId>::venue::<venueId>::benefit::<benefitId>), stamp (gives a stamp; target org::<orgId>::venue::<venueId>::stampcard::<stampCardId>), redirect (target an https URL) or none (target null). Every scan of a link whose target names a venue emits a smart_link.scanned event to each of the organization's endpoints subscribed to it. webhook: { endpointId, ref } additionally ties the tag to one endpoint (its id from list_webhook_endpoints or get_pos_connection's endpoint.id; create_webhook_endpoint / set_pos_connection first): ref is that receiver's own reference for the tag, such as a cash register id, echoed to it as posRef. webhook: null drops the tie. smartCardPublicId (a card's publicId from list_nfc_cards) attaches that NFC card to the link so a tap opens it. A card already attached to another link is refused (409): first detach it with update_smart_link on that link, smartCardPublicId: null, which detaches every card from it.
Inputs: body (required), orgId.
create_webhook_endpointCreate webhook endpointAInspect
Add a webhook endpoint (requires the admin role). Omit secret to have one generated: it is returned once in secret and never again, so show it to the user. name defaults to the URL's host. Plain http URLs are accepted for localhost only. Events are POSTed as JSON with an HMAC signature in X-Cluby-Signature (t=<unix>,v1=<hex hmac-sha256(secret, "<t>.<body>")>). Event types: smart_link.scanned (A member scanned a smart link or NFC tag whose target names a venue (sent to every endpoint subscribed to it; posRef only to the endpoint the tag is tied to).). Includes (optional sections added to each event's data): profile (The member's display name, profile photo URL and the date they joined the event's venue.), membershipCards (Membership / VIP cards the member holds at the venue, valid now.), benefits (Benefits the member can activate at the venue right now — a spent one, one outside its schedule, or a members-only one the member does not hold is left out (name, price text, and for the POS channel an actionId and its single-use redeemUrl).), stampCards (The member's stamp cards in the organization, with stamps and the number to fill (and for the POS channel an actionId and awardStampUrl on the cards that run at the scanned venue).), items (Items the member holds that are usable at the scanned venue — rewards earned (a full stamp card, a birthday gift) and products bought — with units left (and for the POS channel an actionId and a useUrl, good for as many uses as there are units, at most 10).).
Inputs: url (required), name, orgId, events, +3 more.
dashboard_summaryDashboard summaryARead-onlyInspect
Headline numbers, the same figures as the Partner Hub dashboard: benefit activations, event entrances, push messages, returning members and page visitors, with 30-day trends. Covers every venue of the organization unless venue is given. Stamp figures are summed across all stamp cards in scope: rewardsEarned counts rewards minted from stamp cards and rewardsRedeemed those the member actually claimed, matching the per-card stats in list_stamp_cards.
Inputs: orgId, venue.
delete_pos_connectionDelete POS connectionADestructiveIdempotentInspect
Remove the organization's POS connection and the webhook endpoint it manages; register tags keep their refs. The connected app itself is revoked in the Partner Hub (Integrations → Connected apps). Requires the admin role. Confirm with the user before calling this.
Inputs: orgId.
delete_webhook_endpointDelete webhook endpointADestructiveIdempotentInspect
Remove a webhook endpoint; smart links pointing at it are detached (they keep their ref) and a POS connection using it as its channel is left without one. Requires the admin role. Confirm with the user before calling this.
Inputs: endpointId (required), orgId.
get_pos_connectionGet POS connectionARead-onlyInspect
The organization's POS connection — the connected app that owns it, its event channel (a webhook endpoint subscribed to smart_link.scanned), the article search URL and capabilities.apply (which apply instructions the POS executes) — or null. Secrets are never returned.
Inputs: orgId.
import_imageImport imageAInspect
Import a photo from a public https URL into the organization's image storage, the same as picking an image in the Partner Hub. Returns originalUrl and image; pass image unchanged as a benefit's content.image in create_benefit or update_benefit, which wait for the processed versions before saving. Only images imported this way are accepted by the benefit write tools; a birthday gift takes the originalUrl as content.imageUrl.
Inputs: url (required), orgId, attribution.
link_benefit_articlesLink benefit to POS articlesADestructiveIdempotentInspect
Link a benefit (benefitId from list_benefits) to the organization's POS provider's articles, by the article ids the provider's receipts name. When a cashier redeems the benefit through its action link, the answer's apply then names these articles so the till adds the right one; without a link the till adds a line by name. posArticles is the full set: [] clears it. priceListId names the price list (a price group, a menu) the till adds the article from when the provider prices it per list; name, categoryId and categoryName are kept for the Hub to show. Requires the admin role on the benefit's venue and a POS connection (get_pos_connection).
Inputs: benefitId (required), posArticles (required), orgId.
list_benefitsList benefitsBRead-onlyInspect
Benefits (member perks) of an organization. With includeStats, add activation counts for the statsFrom–statsTo date range.
Inputs: orgId, statsTo, statsFrom, includeStats.
list_birthday_giftsList birthday giftsARead-onlyInspect
Birthday gifts of an organization: the gift each member receives around their birthday, with the venues it applies to, its message, validity and delivery timing. With includeStats, each gift gets rewardsGiven (gifts sent to members) and rewardsRedeemed (gifts members actually claimed), each in total and for the last 30 days. Use it to answer how many birthday gifts have been sent or redeemed.
Inputs: orgId, includeStats.
list_connected_appsList connected appsARead-onlyInspect
Apps connected to the organization with "Connect Cluby" (OAuth, pos scope): each is a service account with the admin role — id (what get_pos_connection reports as connectedAppId), name, client id, scopes, when it connected and last used its key. An organization admin revokes one in the Partner Hub (Integrations → Connected apps).
Inputs: orgId.
list_eventsList eventsARead-onlyInspect
Events of an organization with ticket types. Filter by time (upcoming, past) and status; includeStats adds sales figures. publicUrl is the consumer web address for the current environment.
Inputs: orgId, timeFilter, includeStats, statusFilter.
list_nfc_cardsList NFC cardsARead-onlyInspect
The organization's physical NFC cards: publicId (the 4-character id printed on the card — what create_smart_link / update_smart_link take as smartCardPublicId), nfcUid, secure (NTAG 424 with a key: taps are verified and the card can carry a stamp tag), tapCount, and the smart link it is attached to (smartLinkId, smartLinkSlug; null when loose). Cards are registered by Cluby; this lists and does not create them.
Inputs: orgId.
list_orgsList organizationsARead-onlyInspect
Organizations (and their venues) this API key can access. Call this first: every other tool takes an organization's id as orgId.
Inputs: page, search, perPage.
list_pos_identificationsList POS identificationsARead-onlyInspect
Who is at the till: the open identifications (scans still within their expiresAt) on the POS connection's channel, newest first, each the smart_link.scanned data as delivered (member, profile, cards, benefits, stamp cards, items, sequence, expiresAt; action links and profileUrl for admins only) plus eventId, the scan event's id, which a reported sale sends as identificationId. posRef narrows to one till.
Inputs: limit, orgId, posRef.
list_smart_linksList smart linksBRead-onlyInspect
Smart links (QR / NFC tag targets) of an organization with their public url, action, target, NFC card count, visit count and webhook ({ endpointId, ref } when the tag is tied to an endpoint, null otherwise). action is what the link does when scanned: join (member joins the venue; target venue::<venueId>), show (opens the venue or a benefit; target venue::<venueId> or org::<orgId>::venue::<venueId>::benefit::<benefitId>), stamp (gives a stamp; target org::<orgId>::venue::<venueId>::stampcard::<stampCardId>), redirect (target an https URL) or none (target null). Every scan of a link whose target names a venue emits a smart_link.scanned event to each of the organization's endpoints subscribed to it. webhook: { endpointId, ref } additionally ties the tag to one endpoint (its id from list_webhook_endpoints or get_pos_connection's endpoint.id; create_webhook_endpoint / set_pos_connection first): ref is that receiver's own reference for the tag, such as a cash register id, echoed to it as posRef. webhook: null drops the tie. smartCardPublicId (a card's publicId from list_nfc_cards) attaches that NFC card to the link so a tap opens it. A card already attached to another link is refused (409): first detach it with update_smart_link on that link, smartCardPublicId: null, which detaches every card from it.
Inputs: orgId.
list_stamp_cardsList stamp cardsBRead-onlyInspect
Stamp (loyalty punch) cards of an organization with per-card stats: members who started the card, stamps given, rewardsEarned (rewards minted) and rewardsRedeemed (rewards actually claimed).
Inputs: orgId.
list_status_cardsList status cardsBRead-onlyInspect
Membership (status) cards of an organization: tiers members can hold, with pricing and linked benefits.
Inputs: orgId, includeStats.
list_venuesList venuesCRead-onlyInspect
Venues (locations) of an organization with their public ids.
Inputs: orgId.
list_webhook_endpointsList webhook endpointsARead-onlyInspect
The organization's webhook endpoints (name, URL, subscribed events, includes, enabled, and posConnectionId when one is a POS connection's channel). Secrets are never returned. Every event goes to every enabled endpoint subscribed to its type. Events are POSTed as JSON with an HMAC signature in X-Cluby-Signature (t=<unix>,v1=<hex hmac-sha256(secret, "<t>.<body>")>). Event types: smart_link.scanned (A member scanned a smart link or NFC tag whose target names a venue (sent to every endpoint subscribed to it; posRef only to the endpoint the tag is tied to).). Includes (optional sections added to each event's data): profile (The member's display name, profile photo URL and the date they joined the event's venue.), membershipCards (Membership / VIP cards the member holds at the venue, valid now.), benefits (Benefits the member can activate at the venue right now — a spent one, one outside its schedule, or a members-only one the member does not hold is left out (name, price text, and for the POS channel an actionId and its single-use redeemUrl).), stampCards (The member's stamp cards in the organization, with stamps and the number to fill (and for the POS channel an actionId and awardStampUrl on the cards that run at the scanned venue).), items (Items the member holds that are usable at the scanned venue — rewards earned (a full stamp card, a birthday gift) and products bought — with units left (and for the POS channel an actionId and a useUrl, good for as many uses as there are units, at most 10).).
Inputs: orgId.
list_webhook_eventsList webhook eventsARead-onlyInspect
The organization's webhook log, newest first: every event sent (or due) to its endpoints with the delivery attempts — status (pending | delivered | failed | expired | dropped), HTTP status, error and the head of the receiver's response. Use it to answer "did the POS get the scan at 12:03 and what did it say". Filter by endpointId, type, status, since (ISO); page with cursor = the previous page's nextCursor. Below the admin role, capability URLs and the receivers' answers come back null.
Inputs: type, limit, orgId, since, +3 more.
member_statsMember statisticsARead-onlyInspect
Members currently joined (users who joined and have not left), split by venue and by membership card, plus the cumulative members timeline trimmed to the last 90 days. Covers every venue of the organization unless venue is given. The timeline can dip when members leave, so a past point can exceed the current count.
Inputs: orgId, venue.
org_activityRecent activityBRead-onlyInspect
Recent member activity in an organization: benefit activations, joins, purchases, stamps, event check-ins. Newest first, paginated.
Inputs: page, limit, orgId, venues, +1 more.
replay_webhook_eventReplay webhook eventAInspect
Deliver a webhook event again (eventId from list_webhook_events): same id and body, so the receiver deduplicates; the attempt lands in the log as trigger: replay. Ignores the event's expiry, not a disabled endpoint. Each call sends again. Requires the admin role.
Inputs: eventId (required), orgId.
search_pos_articlesSearch POS articlesARead-onlyInspect
Search the organization's POS provider's catalogue, live through its article search: articles by name (query), within a category (categoryId) or exactly by ids, or with kind: "categories" the venue's categories. venueId is one of the organization's venues, its id from list_venues. The ids and price lists in the answer are what link_benefit_articles and a stamp card's article rule take. Cluby keeps no copy of the catalogue, so this needs the POS connection's articleSearchUrl (get_pos_connection) and the provider's service to answer; 400 without the former (404 without an enabled connection), 502 with the reason when the latter does not answer the contract.
Inputs: venueId (required), ids, kind, after, +4 more.
set_pos_connectionSet POS connectionADestructiveIdempotentInspect
Create or update the organization's POS connection (requires the admin role; one per organization). Called with a connected app's token the app becomes its owner. endpoint: { url, secret?, includes? } creates — or on a later call edits — the connection's event channel; webhookEndpointId adopts an existing endpoint instead. Generated secrets (secret for Cluby → POS calls, endpointSecret for a created endpoint) are returned once, so show them to the user. Only the fields sent change.
Inputs: name, orgId, secret, enabled, +4 more.
test_article_searchTest the article searchAInspect
Make one signed call to the POS connection's article search (the venue's categories by default, or what query, categoryId, ids and kind ask for) and report what happened: the URL called, the provider's HTTP status and time, the reason when it failed, and the answer when it matched the contract. The outcome is kept on the connection as articleSearch. Nothing changes on the provider's side. Requires the admin role.
Inputs: ids, kind, limit, orgId, +3 more.
test_smart_link_webhookTest smart link webhookAInspect
Deliver one test smart_link.scanned event (test: true, sample member data) for a smart link to the endpoint it points at, synchronously, and return the event sent and the receiver's response (HTTP status, duration, error). Use it to check the URL, the signature and the tag routing before a real scan. Requires the admin role and a link with webhook set.
Inputs: smartLinkId (required), orgId.
test_webhook_endpointTest webhook endpointAInspect
Deliver one test smart_link.scanned event (test: true, sample tag and member) to a webhook endpoint, synchronously, and return the event sent and the receiver's response (HTTP status, duration, error). Checks the URL and the signature before any tag exists; test_smart_link_webhook also checks a tag's posRef routing. Requires the admin role.
Inputs: endpointId (required), orgId.
update_benefitUpdate benefitADestructiveIdempotentInspect
Edit a benefit (benefitId is the id from list_benefits). Only the fields sent change; content and activation are merged field by field, so send just the keys being edited. Requires the admin role on the benefit's venue. To change the photo, call import_image and pass its image as content.image; content.image: null removes it. Set status to hidden to hide it from members or active to show it again. visibleToStatusCards: [] makes it visible to every member; activation.schedules: null removes its schedules. Fields owned by a campaign or the partner product catalogue (see campaign and productVariantId) can be overwritten by them later.
Inputs: benefitId (required), orgId, status, content, +6 more.
update_birthday_giftUpdate birthday giftADestructiveIdempotentInspect
Edit a birthday gift (giftId is the id from list_birthday_gifts). Only the fields sent change; content and options are merged field by field, so send just the keys being edited, and at least one field is required. Requires the admin role on every venue the gift currently applies to and on any venue in a new venueIds. Set status to hidden to stop it going out or active to resume it. Changing it affects members' upcoming gifts, so confirm with the user first.
Inputs: giftId (required), orgId, status, content, +3 more.
update_smart_linkUpdate smart linkADestructiveIdempotentInspect
Edit a smart link (smartLinkId is the id from list_smart_links). Only the fields sent change. Requires the admin role. action is what the link does when scanned: join (member joins the venue; target venue::<venueId>), show (opens the venue or a benefit; target venue::<venueId> or org::<orgId>::venue::<venueId>::benefit::<benefitId>), stamp (gives a stamp; target org::<orgId>::venue::<venueId>::stampcard::<stampCardId>), redirect (target an https URL) or none (target null). Every scan of a link whose target names a venue emits a smart_link.scanned event to each of the organization's endpoints subscribed to it. webhook: { endpointId, ref } additionally ties the tag to one endpoint (its id from list_webhook_endpoints or get_pos_connection's endpoint.id; create_webhook_endpoint / set_pos_connection first): ref is that receiver's own reference for the tag, such as a cash register id, echoed to it as posRef. webhook: null drops the tie. smartCardPublicId (a card's publicId from list_nfc_cards) attaches that NFC card to the link so a tap opens it. A card already attached to another link is refused (409): first detach it with update_smart_link on that link, smartCardPublicId: null, which detaches every card from it.
Inputs: body (required), smartLinkId (required), orgId.
update_webhook_endpointUpdate webhook endpointADestructiveIdempotentInspect
Edit a webhook endpoint (requires the admin role). Only the fields sent change; a secret sent replaces the stored one. Events are POSTed as JSON with an HMAC signature in X-Cluby-Signature (t=<unix>,v1=<hex hmac-sha256(secret, "<t>.<body>")>). Event types: smart_link.scanned (A member scanned a smart link or NFC tag whose target names a venue (sent to every endpoint subscribed to it; posRef only to the endpoint the tag is tied to).). Includes (optional sections added to each event's data): profile (The member's display name, profile photo URL and the date they joined the event's venue.), membershipCards (Membership / VIP cards the member holds at the venue, valid now.), benefits (Benefits the member can activate at the venue right now — a spent one, one outside its schedule, or a members-only one the member does not hold is left out (name, price text, and for the POS channel an actionId and its single-use redeemUrl).), stampCards (The member's stamp cards in the organization, with stamps and the number to fill (and for the POS channel an actionId and awardStampUrl on the cards that run at the scanned venue).), items (Items the member holds that are usable at the scanned venue — rewards earned (a full stamp card, a birthday gift) and products bought — with units left (and for the POS channel an actionId and a useUrl, good for as many uses as there are units, at most 10).).
Inputs: endpointId (required), url, name, orgId, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRemote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.MIT
- AlicenseCqualityCmaintenanceCompetitor Monitor AI - MCP server providing AI-powered tools and automation by MEOK AI Labs112 npm37 PyPIMIT
- AlicenseAqualityDmaintenanceEnables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.1611 npm1MIT

industrylens-mcpofficial
AlicenseNot gradedqualityCmaintenanceBrowse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.