Skip to main content
Glama

Modifier ma carte de fidélité

modifier_carte
Destructive

Change un ou plusieurs réglages de la carte de fidélité du commerce, en un seul appel : nom imprimé, style (collection, palette ou couleur libre), tampon, règle de récompense (mode tampons/paliers/points, seuils, récompenses), tampons offerts à l’inscription, expiration des récompenses, en mode paliers la forme de la carte (forme_paliers : tampons ou l’une des cinq formes), et en mode points le nom des points, la forme de la carte (forme_points), la valeur par défaut d’un passage, les raccourcis et les points par euro. Seuls les réglages donnés changent ; lire d’abord la carte avec voir_carte. Appeler avec confirmer=false (défaut) pour montrer l’avant/après, puis avec confirmer=true après accord explicite. Un changement de règle s’applique aussi aux cartes déjà chez les clients. Les images (logo, fond, tampon en image) se changent dans l’application, page Carte.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "modifier_carte"
  }
}

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).
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.
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).
conversionNoPassage tampons ↔ points seulement : combien de points vaut UN tampon (ex. 15). Les soldes des cartes ouvertes et, si aucune récompense n’est donnée, les seuils sont convertis avec. Défaut : le dernier ratio choisi, sinon le panier moyen en points, sinon 10.
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.
nom_des_pointsNoMode points : comment s’appellent les points (« points », « graines », « étoiles »…).
points_par_euroNoMode points : points par euro dépensé, repère affiché au commerçant (ex. 1 ou 0,5).
points_par_defautNoMode points : points posés par défaut à chaque passage (1 à 100 000).
points_raccourcisNoMode points : les valeurs proposées d’un geste au scan (jusqu’à 6, triées et dédoublonnées). Ex. [1, 2, 5, 10].
tampons_bienvenueNoTampons offerts à l’inscription du client (0 à 5). 1 par défaut : une carte entamée donne envie d’être finie.
expiration_recompense_joursNoJours pendant lesquels une récompense gagnée reste valable : 0, 30, 60, 90, 180, 365 (0 = n’expire pas).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / conversion
      Added value: +{
      +  "description": "Passage tampons ↔ points seulement : combien de points vaut UN tampon (ex. 15). Les soldes des cartes ouvertes et, si aucune récompense n’est donnée, les seuils sont convertis avec. Défaut : le dernier ratio choisi, sinon le panier moyen en points, sinon 10.",
      +  "maximum": 100000,
      +  "minimum": 0.01,
      +  "type": "number"
      +}
  2. First observed

TDQS

A4.5/5.0
Behavior5/5

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

Annotations already flag destructive=true and non-idempotent, and the description adds genuinely non-derivable behavior: only the supplied settings change, a rule change retroactively applies to cards already held by customers, and the default call is a no-op preview. The propagation-to-existing-cards warning is exactly the kind of side effect an agent cannot infer from structured fields.

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 the set of changeable settings, then the operating rules, then the exclusion — a sensible order, and the long enumeration is justified by 19 parameters. It is a single dense paragraph, though, and the form/point enumerations restate schema content, so a small amount of text could be trimmed.

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 19-parameter destructive mutation with no output schema, the definition covers the preview flow, partial-update semantics, retroactive effect on customer cards, and out-of-scope assets. It does not mention required permission level or what the preview response looks like, which are the remaining gaps an agent might want.

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 enums, bounds and defaults is already documented in the schema, and the precedence rules (palette ignored if couleur given, recompense ignored if paliers given) are duplicated there too. The description adds only a light mode-to-parameter mapping, so the baseline 3 applies.

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 ("Change") and resource ("la carte de fidélité du commerce"), then enumerates the exact settings covered, including the mode-conditional ones (forme_paliers in paliers, nom_des_points/forme_points in points). An agent can tell this is a partial-update tool rather than a read (voir_carte) or a creation tool without opening the schema.

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?

Gives an explicit prerequisite ("lire d'abord la carte avec voir_carte") and an explicit two-step invocation protocol: call with confirmer=false to show the before/after, then confirmer=true only after explicit human agreement. It also excludes a case (images are changed in the app, page Carte), so the agent knows what not to attempt here.

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