Skip to main content
Glama

StampyWallet

Mettre la carte de fidélité en service

creer_commerce

Crée le commerce sur StampyWallet avec la carte conçue (mêmes paramètres que concevoir_carte), et rend un lien personnel pour en devenir propriétaire : la personne clique, se connecte avec son e-mail, et retrouve tout en place (carte, QR à imprimer, essai gratuit). Le logo (logo_url) et la photo de chaque récompense (paliers[].image_url), donnés par leur adresse https, sont posés sur la carte. Sans compte. Appeler d’abord avec confirmer=false pour montrer le récapitulatif, puis avec confirmer=true une fois que la personne a dit oui.

Input Schema

NameRequiredDescriptionDefault
nomYesNom 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).
langueNoLangue des textes rendus. Par défaut, celle du commerce.
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.
confirmerNofalse (défaut) : rend seulement un aperçu de ce qui serait fait, sans rien changer. true : exécute. Toujours montrer l’aperçu à la personne et attendre son accord avant de repasser avec true.
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.
panier_moyenNoDépense moyenne d’un client, en euros (sert aux estimations du tableau de bord).
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.
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.4/5.0
Behavior5/5

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

Goes well beyond the annotations: it discloses the auth model ('Sans compte' — the recipient clicks and signs in with their e-mail), what the returned link unlocks (card, printable QR, free trial), and that logo/photo URLs are fetched and placed on the card. It also explains that confirmer=false produces a preview with no changes, which is the key side-effect distinction for a non-readOnly, non-idempotent creation tool.

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?

The creation action and its outcome come first, then image handling, then the confirmation workflow — a sensible order with no filler. The opening sentence is long and packs the link flow, QR and free trial into one clause, which slightly blurs the front-loading but wastes no words.

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

Completeness5/5

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

For a 21-parameter creation tool with no output schema, the description compensates by describing the return value (the personal ownership link and what the recipient sees) and the preview/execute split. Combined with 100% schema coverage, an agent has everything needed to call it correctly and safely.

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

Parameters3/5

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

Schema description coverage is 100%, so every parameter including the large enums (forme, tampon, metier, paliers) is already fully documented in the schema, and the confirmer semantics in the description merely restate the schema. The only added value is the note that parameters mirror 'concevoir_carte' and that logo_url/paliers[].image_url are fetched over https — useful but marginal. Baseline 3 is appropriate.

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 ('Crée le commerce sur StampyWallet avec la carte conçue') plus the outcome ('rend un lien personnel pour en devenir propriétaire'). It explicitly anchors itself to the sibling 'concevoir_carte' ('mêmes paramètres que concevoir_carte'), so an agent can tell design-a-card apart from create-the-business without opening either schema.

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

Usage Guidelines4/5

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

Gives an explicit call sequence: call first with confirmer=false to show the recap, then with confirmer=true only after the person agrees. That is concrete operational guidance rather than implied usage. It stops short of stating when *not* to use this (e.g. when only a card design is wanted, use concevoir_carte) — that routing is left to inference.

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