# concevoir_carte

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/

Ohne Konto · Nur Lesen.

Gestaltet eine StampyWallet-Kundenkarte (Apple Wallet und Google Wallet) für einen Laden, ohne Konto und ohne etwas zu speichern. Verwenden, wenn jemand eine Stempelkarte möchte, seine Kunden binden will oder sehen möchte, wie seine Karte aussehen würde. Alle Parameter sind optional: Ohne sie wird eine Karte passend zur Branche vorgeschlagen. Das Logo (logo_url) und das Foto jeder Prämie (paliers[].image_url) werden über ihre https-Adresse übergeben; sie werden in der Vorschau gezeigt, ohne gespeichert zu werden. Das Werkzeug mit den zurückgegebenen, angepassten Einstellungen erneut aufrufen, um zu verfeinern. Ist die Person zufrieden, creer_commerce mit denselben Einstellungen vorschlagen.

## Parameter

- `nom` (string, ≤ 80 Zeichen, optional) : Name des Ladens, oben auf die Karte gedruckt.
- `metier` (enum, optional) : Art des Ladens. Wählt einen passenden Stil, Stempel und eine passende Start-Prämie, wenn diese nicht angegeben sind. ongles: Nägel und Wimpern; institut: Kosmetik; barbier: Barbershops und Friseure; patisserie: Konditorei und Chocolaterie; snack: Döner, Burger; sushi: Sushi und Poke; vrac: Unverpackt-Laden; cordonnerie: Schuhmacher und Schlüsseldienst; lavage: Autowäsche; toilettage: Hundesalon; sport: Fitnessstudio; loisirs: Escape Room, Bowling, Lasertag. „autre“: alles, was keine eigene Branche hat. Werte : cafe, boulangerie, patisserie, glacier, restaurant, creperie, sushi, snack, foodtruck, boucherie, fromagerie, primeur, vrac, ongles, institut, barbier, boutique, fleuriste, librairie, animalerie, pressing, cordonnerie, laverie, lavage, toilettage, sport, escalade, loisirs, autre.
- `mode` (enum, optional) : tampons: eine Prämie bei einer Schwelle (am einfachsten). paliers: mehrere Prämien auf derselben Karte (z. B. 5 und 10). points: Der Ladeninhaber gibt bei jedem Besuch eine Anzahl Punkte ein (unterschiedliche Einkaufsbeträge). Werte : tampons, paliers, points.
- `recompense` (string, ≤ 120 Zeichen, optional) : Die Prämie (Modus tampons). Wird ignoriert, wenn „paliers“ angegeben ist.
- `tampons` (integer, 2…30, optional) : Anzahl der Besuche bis zur Prämie (Modus tampons), von 2 bis 30.
- `paliers` (array<object>, ≤ 6, optional) : Die Prämien und ihre Schwellen (Modi paliers und points). Von der kleinsten zur größten.
- `paliers[].a` (integer, 1…1000000, Pflicht) : Schwelle: Anzahl Stempel (oder Punkte im Modus points), um diese Stufe zu erreichen.
- `paliers[].recompense` (string, ≤ 120 Zeichen, Pflicht) : Was der Kunde bekommt, so wie es auf der Karte steht. Z. B. „Ein Kaffee gratis“.
- `paliers[].icone` (enum, optional) : Icon der Stufe (Standard: cadeau). Werte : 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, couteau, carotte, bocal, esquimau, 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, croissant.
- `paliers[].image_url` (string, ≤ 2000 Zeichen, optional) : Foto der Prämie, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB, mindestens 64 px Seitenlänge). Wenn möglich freigestellt, ersetzt es das Icon auf der Karte: grau, bevor die Prämie verdient ist, danach farbig. Wird in den Modi paliers und points gezeichnet.
- `collection` (enum, optional) : Stil der Karte: original (schlicht), cafe (feiner Rahmen), botanique (kursiv, Blätter), trattoria (gewellter Rand), atelier (modern), pass (wie ein Apple Wallet Pass: großes Logo, Stempel als Objekte mit Schatten, kräftiger Hintergrund). Werte : original, cafe, botanique, trattoria, atelier, pass.
- `palette` (integer, 0…3, optional) : Palette der Kollektion: 0, 1 oder 2 (jede Kollektion bietet drei; pass bietet eine vierte, 3). Wird ignoriert, wenn „couleur“ angegeben ist.
- `couleur` (string, optional) : Freie Hintergrundfarbe, hexadezimal. Die Schriftfarbe (Text) wird automatisch so gewählt, dass sie lesbar bleibt.
- `tampon` (enum, optional) : Das Zeichen, das bei jedem Besuch gesetzt wird. „rond“: der einfache Punkt. Beauty: 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. Sonstiges: 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. Werte : 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, couteau, carotte, bocal, esquimau, 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, croissant.
- `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die der Kunde bei der Anmeldung geschenkt bekommt (0 bis 5). Standard 1: Eine angefangene Karte will man vollmachen.
- `nom_des_points` (string, ≤ 20 Zeichen, optional) : Modus points: wie die Punkte heißen („Punkte“, „Bohnen“, „Sterne“…).
- `forme_paliers` (enum, optional) : Modus paliers: das Aussehen der Karte. tampons (Standard): die Stempel im Raster, jede Prämie an der Stelle des Stempels ihrer Schwelle. Oder eine der fünf Formen der Punkte, die dann Stempel zählt: medailles (ein Balken und eine Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, auf dem jeder Stempel den Marker voranbringt), anneau (ein runder Balken um die nächste Prämie). Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : tampons, medailles, vitrine, remplissage, chemin, anneau.
- `forme_points` (enum, optional) : Modus points: das Aussehen der Karte. medailles (Standard): ein dicker Balken und eine große Medaille pro Prämie. vitrine: die Prämien nebeneinander, jede mit eigenem kleinen Balken. remplissage: die nächste Prämie in groß, die sich nach und nach einfärbt. chemin: ein Weg in S-Form, die Prämien als Etappen. anneau: ein runder Balken um die nächste Prämie, die Liste daneben. Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : medailles, vitrine, remplissage, chemin, anneau.
- `forme` (enum, optional) : Das Aussehen der Karte, in einem Wort (ersetzt forme_points und forme_paliers). Modi points und paliers: medailles (ein Balken und eine große Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, jeder Besuch bringt den Marker voran), anneau (ein runder Balken um die nächste Prämie). Modi tampons und paliers: die Anordnung der Stempel, grille (Standard), libre (verstreut), objets (große Objekte mit Schatten, ideal mit einem Foto), cercles. Bei paliers behält eine Anordnung die Stempel und setzt jede Prämie an die Stelle des Stempels ihrer Schwelle. Eine der fünf Formen ohne angegebenen Modus stellt die Karte auf den Modus paliers um. Werte : medailles, vitrine, remplissage, chemin, anneau, grille, libre, objets, cercles.
- `encre` (string, optional) : Textfarbe der Karte, hexadezimal (Standard: so gewählt, dass sie auf dem Hintergrund lesbar bleibt).
- `accent` (string, optional) : Akzentfarbe: gesetzte Stempel, Balken, Etiketten, hexadezimal (Standard: aus der Kollektion).
- `logo_url` (string, ≤ 2000 Zeichen, optional) : Logo des Ladens, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB): Sein Instagram-Profilbild reicht. Wenn möglich freigestellt, oben auf die Karte gesetzt; ohne Angabe von couleur, palette, encre oder accent übernimmt die Karte die Farben des Logos.
- `variantes` (boolean, optional) : true: erzeugt zusätzlich die drei Paletten der gewählten Kollektion, um eine Auswahl anzubieten. Standard : false.
- `tampons_poses` (integer, 0…1000000, optional) : Bereits gesetzte Stempel in der Vorschau, um eine angefangene Karte zu zeigen (Standard: Willkommensstempel + 2).

## Antwort

Ein PNG-Bild der Karte (`content`, Typ `image`), ein Text, der die getroffenen Entscheidungen zusammenfasst, und die Einstellungen als Daten (`structuredContent`), die Sie angepasst zum Verfeinern oder unverändert an `creer_commerce` übergeben. Mit `variantes: true` ein zusätzliches Bild pro Palette der Kollektion.

> **Tipp :** Dieses Werkzeug funktioniert ohne Konto und ohne Anmeldung. Geben Sie Ihrem Assistenten die [skill.md](https://stampywallet.com/de/docs/skill/), damit er mehrere Versionen der Karte vorschlägt.

## Beispiel

Prompt : « Gestalte die Stempelkarte der Boulangerie Lemaire: 10 Besuche, das 10. Baguette gratis, Stil Pass, mit ihrem Logo. »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "concevoir_carte",
    "arguments": {
      "nom": "Boulangerie Lemaire",
      "metier": "boulangerie",
      "mode": "tampons",
      "tampons": 10,
      "recompense": "Das 10. Baguette gratis",
      "collection": "pass",
      "logo_url": "https://example.com/logo-lemaire.png",
      "variantes": true
    }
  }
}
```

```bash
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/call","params":{"name":"concevoir_carte","arguments":{"nom":"Boulangerie Lemaire","metier":"boulangerie","mode":"tampons","tampons":10,"recompense":"Das 10. Baguette gratis","collection":"pass","logo_url":"https://example.com/logo-lemaire.png","variantes":true}}}'
```
