Skip to main content
Glama

StampyWallet

Concevoir une carte de fidélité

concevoir_carte
Read-onlyIdempotent

Dessine une carte de fidélité StampyWallet (Apple Wallet et Google Wallet) pour un commerce, sans compte et sans rien enregistrer. À utiliser quand quelqu’un veut une carte de fidélité, fidéliser ses clients, ou voir à quoi ressemblerait sa carte. Tous les paramètres sont facultatifs : sans eux, une carte adaptée au métier est proposée. Le logo (logo_url) et la photo de chaque récompense (paliers[].image_url) se donnent par leur adresse https ; ils sont montrés sur l’aperçu, sans être enregistrés. Rappeler l’outil avec les réglages rendus, modifiés, pour affiner. Quand la personne est satisfaite, proposer creer_commerce avec les mêmes réglages.

Input Schema

NameRequiredDescriptionDefault
nomNoNom du commerce, imprimé en haut de la carte.
modeNotampons : une récompense à un seuil (le plus simple). paliers : plusieurs récompenses sur la même carte (ex. 5 et 10). points : le commerçant saisit un nombre de points à chaque passage (paniers variables).
encreNoCouleur du texte de la carte, en hexadécimal (défaut : choisie pour rester lisible sur le fond).
formeNoLe dessin de la carte, en un mot (remplace forme_points et forme_paliers). Modes points et paliers : medailles (une jauge et une grande médaille par récompense), vitrine (les récompenses côte à côte, chacune sa jauge), remplissage (la prochaine récompense en grand, qui se colore), chemin (une route en S, chaque passage fait avancer le curseur), anneau (une jauge ronde autour de la prochaine récompense). Modes tampons et paliers : la disposition des tampons, grille (défaut), libre (semés), objets (gros objets ombrés, idéal avec une photo), cercles. En paliers, une disposition garde les tampons et pose chaque récompense à la place du tampon de son seuil. Une des cinq formes sans mode donné passe la carte en mode paliers.
accentNoCouleur d’accent : les tampons posés, les jauges, les étiquettes, en hexadécimal (défaut : tirée de la collection).
metierNoType de commerce. Choisit un style, un tampon et une récompense de départ adaptés quand ils ne sont pas précisés. ongles : ongles et cils ; institut : esthétique ; barbier : barbiers et coiffeurs ; patisserie : pâtisserie et chocolaterie ; snack : kebab, burger ; sushi : sushi et poke ; vrac : épicerie vrac ; cordonnerie : cordonnerie et clés ; lavage : lavage auto ; toilettage : toilettage d’animaux ; sport : salle de sport ; loisirs : escape game, bowling, laser game. « autre » : tout ce qui n’a pas son métier.
tamponNoLe signe posé à chaque passage. « rond » : le point simple. Beauté : etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food : cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau. Divers : feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion.
couleurNoCouleur de fond libre, en hexadécimal. L’encre (texte) est choisie automatiquement pour rester lisible.
paletteNoPalette de la collection : 0, 1 ou 2 (chaque collection en propose trois ; pass en propose une quatrième, 3). Ignorée si « couleur » est donnée.
paliersNoLes récompenses et leurs seuils (modes paliers et points). Du plus petit au plus grand.
tamponsNoNombre de passages pour obtenir la récompense (mode tampons), de 2 à 30.
logo_urlNoLogo du commerce, par son adresse https (PNG, JPEG ou WebP, 5 Mo au plus) : sa photo de profil Instagram fait l’affaire. Détouré quand c’est possible, posé en haut de la carte ; sans couleur, palette, encre ni accent donnés, la carte prend les couleurs du logo.
variantesNotrue : rend aussi les trois palettes de la collection choisie, pour proposer un choix.
collectionNoStyle de la carte : original (sobre), cafe (cadre fin), botanique (italique, feuillages), trattoria (festonné), atelier (moderne), pass (comme un pass Apple Wallet : logo en grand, tampons en objets ombrés, fond franc).
recompenseNoLa récompense (mode tampons). Ignorée si « paliers » est donné.
forme_pointsNoMode points : le dessin de la carte. medailles (défaut) : une jauge épaisse et une grande médaille par récompense. vitrine : les récompenses côte à côte, chacune sa petite jauge. remplissage : la prochaine récompense en grand, qui se colore à mesure. chemin : une route en S, les récompenses en étapes. anneau : une jauge ronde autour de la prochaine récompense, la liste à côté. Les photos des récompenses se déposent dans l’application, page Carte.
forme_paliersNoMode paliers : le dessin de la carte. tampons (défaut) : les tampons en grille, chaque récompense à la place du tampon de son seuil. Ou l’une des cinq formes des points, qui compte alors des tampons : medailles (une jauge et une médaille par récompense), vitrine (les récompenses côte à côte, chacune sa jauge), remplissage (la prochaine récompense en grand, qui se colore), chemin (une route en S où chaque tampon fait avancer le curseur), anneau (une jauge ronde autour de la prochaine récompense). Les photos des récompenses se déposent dans l’application, page Carte.
tampons_posesNoTampons déjà posés sur l’aperçu, pour montrer une carte en cours (défaut : tampons de bienvenue + 2).
nom_des_pointsNoMode points : comment s’appellent les points (« points », « graines », « étoiles »…).
tampons_bienvenueNoTampons offerts à l’inscription du client (0 à 5). 1 par défaut : une carte entamée donne envie d’être finie.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is covered. The description adds genuinely non-obvious behavior: nothing is persisted, logo and reward images are displayed in the preview but not stored, and all parameters are optional with business-adapted defaults. It does not describe what the preview response actually contains (image, link, structured data), which is the remaining gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and scope, then usage, then defaults, then iteration, then handoff — a logical order with no filler. It is dense but every sentence carries a distinct instruction; only the image-URL sentence is slightly redundant with the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 20-parameter, zero-required, no-output-schema tool, the description covers the workflow, the optionality, the image handling and the follow-up tool. The one omission is the return value: with no output schema, the agent is not told whether the preview comes back as an image, a URL, or a structured card, which matters for relaying results to the user.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3 and the schema already carries the enum and format semantics. The description still adds value by explaining the optionality contract ('sans eux, une carte adaptée au métier est proposée') and by clarifying that logo_url and paliers[].image_url are https addresses shown in the preview without being saved — behavior the schema does not state.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Dessine une carte de fidélité StampyWallet') plus the crucial scope constraint ('sans compte et sans rien enregistrer'). It also implicitly separates itself from creer_commerce by naming that sibling as the next step, so an agent can distinguish preview from creation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit trigger conditions are given ('quand quelqu’un veut une carte de fidélité, fidéliser ses clients, ou voir à quoi ressemblerait sa carte'), plus an iteration loop ('Rappeler l’outil avec les réglages rendus, modifiés') and a handoff rule to creer_commerce when satisfied. This is when/when-next guidance, not just implied usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources