Connect an AI assistant
The StampyWallet MCP server connects Claude, ChatGPT, Cursor or an agent to your loyalty card. One address, no key, and nothing changes without your approval.
StampyWallet speaks the Model Context Protocol (MCP), the standard that lets an AI assistant use tools. Once connected, you can ask in a conversation: "design me a loyalty card", "how many customers came this month?", "tell my regulars I'm closed on Monday".
The server address
https://app.stampywallet.com/mcpStreamable HTTP, JSON responses, stateless. It is the only thing you need to give your assistant.
Settings › Connectors › Add custom connector, paste the address. Step by step: Claude.
Settings › Apps and connectors, developer mode, Create, paste the address. Step by step: ChatGPT.
{
"mcpServers": {
"stampywallet": { "url": "https://app.stampywallet.com/mcp" }
}
}Step by step, plus Claude Code: Cursor and agents.
Without an account, then with your account
The server offers two families of tools at the same address:
- Without an account:
concevoir_cartedesigns a card that looks like a business,simuler_fideliteworks out what it costs, andcreer_commerceputs it live and returns a link to take ownership of it. No sign-in is needed. - With your account: your numbers, your customers, your messages, Google reviews, card settings, the poster, the team. On the first call, the assistant opens the StampyWallet sign-in page (OAuth): you sign in, choose the business, and allow access.
On the authorization screen, you can tick read only: the assistant reads your numbers and settings, but cannot change anything. Access is managed in Settings › Your data › Connected assistants, where each assistant can be turned off in one click.
| Scope | What it allows |
|---|---|
stampy.lecture | Read your numbers, your customers (first names), your settings and your card |
stampy.ecriture | Act for you: messages to customers, settings, card, team, always after your approval in the conversation |
Nothing changes without your approval
Tools that write take a confirmer parameter, false by default. Called that way, they do nothing: they return a preview (the exact text of a message and the number of recipients, the before and after of a setting). The assistant shows it to you, and only calls the tool again with confirmer: true after your "yes".
Warning : two things can only be done at the counter, by scanning the customer's card: adding stamps and giving rewards. No MCP tool does it. To add them from a POS, there is the API.
The tools
| Tool | Account | Effect |
|---|---|---|
concevoir_carte | No | Read only |
simuler_fidelite | No | Read only |
creer_commerce | No | Writes (confirm) |
tableau_de_bord | Yes | Read only |
rentabilite | Yes | Read only |
meilleurs_moments | Yes | Read only |
chercher_clients | Yes | Read only |
fiche_client | Yes | Read only |
envoyer_message | Yes | Writes (confirm) |
historique_messages | Yes | Read only |
regler_automatismes | Yes | Writes (confirm) |
fermetures | Yes | Writes (confirm) |
avis_google | Yes | Writes (confirm) |
voir_carte | Yes | Read only |
modifier_carte | Yes | Writes (confirm) |
fiche_commerce | Yes | Writes (confirm) |
affichette | Yes | Read only |
envoyer_affichette | Yes | Writes (confirm) |
equipe | Yes | Writes (confirm) |
Tools that need an account also follow your role (a staff member has access to none of them; equipe is for the owner only) and your plan (some numbers and Google reviews need Growth).
Try it by hand
The server answers any MCP client, or curl:
curl https://app.stampywallet.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Without an account, calls are rate limited per IP address: beyond the limit, the server asks you to wait a few minutes.
Frequently asked questions
Do I need a key to connect the MCP server?
No, no key at all. The tools that need no account work right away; for your figures and your customers, the assistant asks you to connect your StampyWallet account on the first call.
Does it work with free ChatGPT?
On the StampyWallet side, there is nothing to pay to connect the server, and the tools that need no account are open to everyone. On the ChatGPT side, the connector is created in developer mode, and access to it depends on your ChatGPT plan. If yours does not offer it, Claude, Cursor or any other MCP client connects to the same address.
Can the assistant change anything without my approval?
No. Tools that write first return a preview, and the assistant only calls them again with confirmer: true after your "yes". You can also allow read-only access.
Can the assistant add stamps?
No. Adding stamps and giving rewards is only done at the counter, by scanning the customer's card. From a POS, the API does it.
How do I cut off an assistant's access?
In Settings › Your data › Connected assistants: each assistant is cut off in one click.
Updated