MCP et IA / Outils avec compte / tableau_de_bord

tableau_de_bord

Avec compteLecture seule

Les chiffres de fidélité du commerce sur une période au choix : passages en caisse, clients venus, nouveaux clients, taux de retour, récompenses gagnées et offertes, chiffre estimé, avec une courbe par jour, semaine ou mois et, au besoin, la comparaison avec la période précédente de même durée. À utiliser pour « comment ça marche ce mois-ci ? », « combien de clients en août ? », « est-ce que ça monte ? ». Pour la liste des clients, utiliser chercher_clients ; pour savoir si la carte rapporte, rentabilite.

Paramètres

periodeenumfacultatif

Période étudiée, en jours du fuseau du commerce, aujourd’hui inclus pour les périodes en cours (ce_mois = du 1er à aujourd’hui). « personnalisee » utilise du/au. Défaut derniers_30_jours.

Valeurs : 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

Défaut : "derniers_30_jours"

dustring (date)facultatif

Premier jour inclus (AAAA-MM-JJ). Le donner suffit : la période devient « personnalisee ».

austring (date)facultatif

Dernier jour inclus (AAAA-MM-JJ). Défaut : aujourd’hui.

comparerbooleanfacultatif

Ajoute la variation par rapport à la période de même durée juste avant (ex. 30 jours avant les 30 derniers jours).

Défaut : true

indicateursarray<enum>, ≤ 9facultatif

Indicateurs à rendre, dans cet ordre. Défaut : tous. taux_retour = part des clients venus sur la période qui étaient déjà venus avant ; chiffre_estime = passages × panier moyen déclaré (une estimation, pas une caisse).

Valeurs : passages clients_venus nouveaux_clients taux_retour passages_par_client recompenses_gagnees recompenses_offertes chiffre_estime total_clients

courbeenumfacultatif

Ce que trace la courbe. Défaut passages.

Valeurs : passages clients_venus nouveaux_clients recompenses_gagnees recompenses_offertes aucune

Défaut : "passages"

granulariteenumfacultatif

Pas de la courbe. auto (défaut) : jour jusqu’à 2 mois, semaine jusqu’à ~9 mois, mois au-delà.

Valeurs : auto jour semaine mois

Défaut : "auto"

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.

Comment ça marche ce mois-ci, par rapport au mois dernier ?

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

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 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é ?