# meilleurs_moments

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

Mit Konto · Nur Lesen · Tarif Wachstum.

Zeigt, wann die Kunden kommen: durchschnittliche Besuche pro Wochentag, Verteilung nach Uhrzeit oder die vollsten Zeitfenster (Tag + Uhrzeit), für einen frei wählbaren Zeitraum und in der Ortszeit des Ladens. Kann auch die Anmeldungen neuer Kunden zählen. Verwenden für „Was ist mein bester Tag?“, „Wann ist bei mir am meisten los?“, „Wann starte ich ein Angebot, um eine Flaute zu füllen?“.

## Parameter

- `par` (enum, optional) : jour_semaine (Standard): Durchschnitt pro Montag, Dienstag…; heure: Summe pro Tagesstunde; creneau: die meistbesuchten Kombinationen aus Tag + Uhrzeit. Werte : jour_semaine, heure, creneau. Standard : "jour_semaine".
- `mesure` (enum, optional) : passages (Standard) oder nouveaux_clients (Anmeldungen zur Karte). Werte : passages, nouveaux_clients. Standard : "passages".
- `jours` (array<enum>, ≤ 7, optional) : Für par=heure oder creneau: nur diese Wochentage behalten (z. B. ["samedi"]). Werte : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche.
- `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_90_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_90_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.
- `limite` (integer, 1…50, optional) : Für par=creneau: Anzahl der gelieferten Zeitfenster (Standard 10). Standard : 10.

## 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 : « Um welche Uhrzeit ist samstags bei mir am meisten los? »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meilleurs_moments",
    "arguments": {
      "par": "heure",
      "jours": [
        "samedi"
      ]
    }
  }
}
```

```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":"meilleurs_moments","arguments":{"par":"heure","jours":["samedi"]}}}'
```

`$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.
