MCP et IA / Outils avec compte / modifier_carte

modifier_carte

Avec compteÉcrit (confirmer)

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.

Paramètres

nomstring, ≤ 80 caractèresfacultatif

Nom du commerce, imprimé en haut de la carte.

modeenumfacultatif

tampons : 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).

Valeurs : tampons paliers points

recompensestring, ≤ 120 caractèresfacultatif

La récompense (mode tampons). Ignorée si « paliers » est donné.

tamponsinteger, 2…30facultatif

Nombre de passages pour obtenir la récompense (mode tampons), de 2 à 30.

paliersarray<object>, ≤ 6facultatif

Les récompenses et leurs seuils (modes paliers et points). Du plus petit au plus grand.

paliers[].ainteger, 1…1000000requis

Seuil : nombre de tampons (ou de points en mode points) pour obtenir ce palier.

paliers[].recompensestring, ≤ 120 caractèresrequis

Ce que le client reçoit, tel qu’imprimé sur la carte. Ex. « Un café offert ».

paliers[].iconeenumfacultatif

Icône du palier (défaut : cadeau).

Valeurs (63)

etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

collectionenumfacultatif

Style 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).

Valeurs : original cafe botanique trattoria atelier pass

paletteinteger, 0…3facultatif

Palette 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.

couleurstringfacultatif

Couleur de fond libre, en hexadécimal. L’encre (texte) est choisie automatiquement pour rester lisible.

tamponenumfacultatif

Le 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. Divers : feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket.

Valeurs (64)

rond etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

tampons_bienvenueinteger, 0…5facultatif

Tampons offerts à l’inscription du client (0 à 5). 1 par défaut : une carte entamée donne envie d’être finie.

nom_des_pointsstring, ≤ 20 caractèresfacultatif

Mode points : comment s’appellent les points (« points », « graines », « étoiles »…).

forme_paliersenumfacultatif

Mode 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.

Valeurs : tampons medailles vitrine remplissage chemin anneau

forme_pointsenumfacultatif

Mode 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.

Valeurs : medailles vitrine remplissage chemin anneau

expiration_recompense_joursinteger, 0…365facultatif

Jours pendant lesquels une récompense gagnée reste valable : 0, 30, 60, 90, 180, 365 (0 = n’expire pas).

points_par_defautinteger, 1…100000facultatif

Mode points : points posés par défaut à chaque passage (1 à 100 000).

points_raccourcisarray<integer>, ≤ 12facultatif

Mode points : les valeurs proposées d’un geste au scan (jusqu’à 6, triées et dédoublonnées). Ex. [1, 2, 5, 10].

points_par_euronumber, 0.01…10000facultatif

Mode points : points par euro dépensé, repère affiché au commerçant (ex. 1 ou 0,5).

confirmerbooleanfacultatif

false (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.

Défaut : false

Réponse

Un texte que lit l'assistant (content), et les mêmes informations en données structurées (structuredContent). En cas de refus (paramètre à corriger, formule, rôle), la réponse porte isError: true et une phrase que l'assistant peut reformuler.

Attention : cet outil écrit. Appelé avec confirmer: false (par défaut), il rend seulement un aperçu, sans rien changer. L'assistant doit vous le montrer et attendre votre accord avant de repasser avec confirmer: true.

Passe ma carte en paliers : un café à 5 passages, un croissant à 10.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "modifier_carte",
    "arguments": {
      "mode": "paliers",
      "paliers": [
        {
          "a": 5,
          "recompense": "Un café offert",
          "icone": "cafe"
        },
        {
          "a": 10,
          "recompense": "Un croissant offert",
          "icone": "croissant"
        }
      ],
      "confirmer": false
    }
  }
}

curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $STAMPY_JETON" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"modifier_carte","arguments":{"mode":"paliers","paliers":[{"a":5,"recompense":"Un café offert","icone":"cafe"},{"a":10,"recompense":"Un croissant offert","icone":"croissant"}],"confirmer":false}}}'

$STAMPY_JETON est le jeton OAuth que l'assistant obtient quand vous connectez votre compte (voir Brancher). Vous n'avez pas à le manipuler vous-même.

Mis à jour le 22 octobre 2026

Cette page vous a aidé ?