# tableau_de_bord

> 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/tableau_de_bord/

Mit Konto · Nur Lesen.

Die Treue-Kennzahlen des Ladens für einen frei wählbaren Zeitraum: Besuche an der Kasse, gekommene Kunden, neue Kunden, Wiederkehrrate, verdiente und eingelöste Prämien, geschätzter Umsatz, mit einer Kurve pro Tag, Woche oder Monat und bei Bedarf dem Vergleich mit dem vorherigen, gleich langen Zeitraum. Verwenden für „Wie läuft es diesen Monat?“, „Wie viele Kunden im August?“, „Geht es aufwärts?“. Für die Kundenliste chercher_clients verwenden; um zu wissen, ob sich die Karte lohnt, rentabilite.

## Parameter

- `periode` (enum, optional) : Untersuchter Zeitraum, in Tagen der Zeitzone des Ladens, heute eingeschlossen bei laufenden Zeiträumen (ce_mois = vom 1. bis heute). „personnalisee“ nutzt du/au. Standard derniers_30_jours. Werte : aujourdhui, hier, derniers_7_jours, derniers_30_jours, derniers_90_jours, derniers_12_mois, cette_semaine, semaine_derniere, ce_mois, mois_dernier, cette_annee, annee_derniere, depuis_le_debut, personnalisee. Standard : "derniers_30_jours".
- `du` (string (date), optional) : Erster Tag, eingeschlossen (JJJJ-MM-TT). Es reicht, ihn anzugeben: Der Zeitraum wird zu „personnalisee“.
- `au` (string (date), optional) : Letzter Tag, eingeschlossen (JJJJ-MM-TT). Standard: heute.
- `comparer` (boolean, optional) : Fügt die Veränderung gegenüber dem gleich langen Zeitraum direkt davor hinzu (z. B. die 30 Tage vor den letzten 30 Tagen). Standard : true.
- `indicateurs` (array<enum>, ≤ 9, optional) : Kennzahlen, die geliefert werden, in dieser Reihenfolge. Standard: alle. taux_retour = Anteil der Kunden im Zeitraum, die schon vorher da waren; chiffre_estime = Besuche × angegebener Durchschnittsbon (eine Schätzung, keine Kassenzahl). Werte : passages, clients_venus, nouveaux_clients, taux_retour, passages_par_client, recompenses_gagnees, recompenses_offertes, chiffre_estime, total_clients.
- `courbe` (enum, optional) : Was die Kurve zeigt. Standard passages. Werte : passages, clients_venus, nouveaux_clients, recompenses_gagnees, recompenses_offertes, aucune. Standard : "passages".
- `granularite` (enum, optional) : Schrittweite der Kurve. auto (Standard): Tag bis 2 Monate, Woche bis ca. 9 Monate, Monat darüber. Werte : auto, jour, semaine, mois. Standard : "auto".

## Antwort

Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann.

## Beispiel

Prompt : « Wie läuft es diesen Monat im Vergleich zum letzten? »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tableau_de_bord",
    "arguments": {
      "periode": "ce_mois",
      "comparer": true
    }
  }
}
```

```bash
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":"tableau_de_bord","arguments":{"periode":"ce_mois","comparer":true}}}'
```

`$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun.
