tappi
PricingSign inGet started

Legal

Connect an AI app to TAPPI

Last updated: 30 October 2026

TAPPI runs an MCP server, the standard way AI apps connect to other software. Connect it and you can ask your AI app about your venue: who stopped coming, which day is quietest, how many rewards are waiting to be used.

Connected AI apps are part of the Scale plan. The venue owner or an admin connects them.

The address

https://www.thetappi.com/api/mcp

You sign in with your TAPPI login, pick the venue and press Allow. The app never sees your password. If your login has two-factor switched on, it asks for the code first.

How to add it

  • Claude (web, desktop and Claude Code): Settings › Connectors › Add custom connector, then paste the address.
  • ChatGPT: in Settings › Connectors, add a custom connector with the address. Your plan has to allow custom connectors.
  • Codex, Cursor, VS Code, Gemini CLI and other MCP clients: add a remote (HTTP) server with the address. The client opens the TAPPI sign-in in your browser.

What it can read

Totals for one venue, and nothing else. Every tool is read-only. None of them returns a customer’s name, email or phone number.

ToolWhat it answers
get_overviewVisits, taps, stamps, rewards issued and redeemed, new members, points, prepaid top-ups and till bills for a date range, with the same-length period before it for comparison. All locations together. Defaults to the last 30 days.
get_liabilityWhat the venue currently owes its customers: rewards earned and not yet used (by reward), stamps on cards in progress, open points, and unspent prepaid and gift-card balances.
get_retention_cohortsMonthly cohorts: for the members who joined in each month, the share who came back in each following month (0 to 1; null for months that have not happened yet).
get_rfmMembers on a 5×5 grid of recency (how recently they came) by frequency (how often). cells[r-1][f-1] counts members; 5 is best on both axes. spendCents is the mean spend score per cell, from bills staff entered.
get_busiest_hoursVisits by day of week and hour over recent weeks, in the venue’s own local time. cells[dow][hour], dow 0 = Sunday. Includes the single busiest slot.
get_lifecycle_groupsHow many members are in each lifecycle group: champions, regulars, new, never visited, slipping, at risk, lost. Thresholds follow the venue’s own visit-cadence setting.
list_saved_segmentsThe audiences the venue saved, with their rules. Names and rules only, never the members.
get_reachHow many people a wallet message would reach right now: distinct customers who agreed to offers and have the pass installed (Apple or Google), overall and per card. Cards are keyed by card_id, the same id list_programs gives, because two cards can share a name. TAPPI does not measure open or tap rates.
list_locationsThe venue’s active locations, by name.
list_programsThe venue’s loyalty cards (stamp, points, prepaid, membership…): id, name, type, whether it is live and the day it was created. Two cards can share a name, so tell them apart by id and creation day, never by name alone.

Some reports come with Growth and above, the same as on the Analytics page. Each answer says what it counts. Prepaid top-ups, for example, are money paid in advance, not sales.

What it cannot do

  • See customer names, emails or phone numbers.
  • Change, send or delete anything: no messages, no stamps, no refunds.
  • Reach another venue, even one on the same login, unless you connect that venue separately.

Your data and your AI app

When the app reads a figure, it leaves TAPPI and goes to the AI provider you chose. From then on, that provider’s terms decide what happens to it. TAPPI does not send it there: you do, by connecting. Check those terms, and your obligations to your own customers, before you connect. Our security page lists what we have and have not built around this.

Every connection is listed in Settings › Connected AI apps, with what it read and when, and you can disconnect it there at any time. Disconnecting ends it straight away.

Limits

30 calls a minute per connection. Access tokens last an hour and renew themselves while the connection is in use. Questions: hello@thetappi.com.

tappi

Loyalty cards for local businesses. Scan the QR, the card lands in Wallet.

Product

  • Pricing
  • Sign in

Legal

  • Terms of service
  • Privacy policy
  • Data processing
  • Sub-processors
  • Cookie policy
  • All documents

Company

  • Trust
  • Security
  • Support

© 2026 Tappi. All rights reserved.