Examiner avant d'enregistrer
Consultez d'abord le récapitulatif actuel ; les enregistrements de grand livre sont des données financières et une entrée dupliquée est plus difficile à corriger qu'une entrée manquante.
ledger({ action: "summary", months: 1 })Outil MCP public
ledger
Objectif
Gérer les transactions financières régies et les rappels de renouvellement de services externes via le répartiteur Ledger, avec récapitulatifs structurés et limites d'audit.
Quand l'utiliser
- Enregistrer une dépense ou une autre transaction prise en charge avec montant, devise, date et contexte du commerçant.
- Lister, résumer ou avoir une vue d'ensemble des enregistrements Ledger autorisés avec filtres de date, catégorie, devise ou projet.
- Créer ou gérer des rappels de renouvellement d'abonnement et éventuellement associer leur cycle de révision aux TODO.
Quand NE PAS l'utiliser
- N'utilisez pas remember générique pour des enregistrements financiers ; ledger préserve le contrat de données financières.
- Ne déduisez pas de total multidevise ; les récapitulatifs séparent les devises lorsqu'une agrégation n'est pas sûre.
- Ne mettez pas à jour et ne supprimez pas d'enregistrement sans l'ID/la version exact requis et l'autorisation de l'utilisateur.
- L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.
Périmètre requis
- Les actions de lecture requièrent memory:read ; les mutations de transactions et d'abonnements requièrent memory:write dans la surface de chat publique.
- La limite authentifiée propriétaire/équipe/périmètre régit chaque enregistrement Ledger et opération de rappel.
Paramètres
| Nom | Type | Description |
|---|---|---|
action | add_expense | list | summary | overview | update_transaction · requis | Opération Ledger sélectionnée par l'appelant. Seules ces cinq valeurs littérales sont acceptées. |
item / amount / transaction_type / currency | string / number | Champs principaux de transaction ; montant et devise sont requis pour les écritures financières. |
transaction_date / category / merchant / payment_method / note | string | Champs facultatifs de classification, de date et de note de transaction. |
query / date_from / date_to / min_amount / max_amount | string / number | Filtres de liste et de récapitulatif. |
transaction_id / expected_version / patch | string / integer / object | Cible exacte de mise à jour, version de concurrence optimiste et champs de mise à jour autorisés. |
owner_timezone / project_id | string | Interprétation de date et limite de projet/équipe autorisée. |
limit / offset / months | integer / boolean · par défaut : 20 / 0 / 6 / false | Contrôles de pagination, d'horizon de récapitulatif et de sortie structurée. |
Schéma de retour
La sortie structurée contient la transaction demandée, les groupes de récapitulatif ou la vue d'ensemble ainsi qu'un résumé textuel destiné à l'utilisateur. Les appelants de widget peuvent recevoir des métadonnées d'actualisation ; les secrets bruts ne font jamais partie du contrat de réponse.
Exemples
ledger({
action: "add_expense",
item: "Domain renewal",
amount: 18.00,
currency: "USD",
transaction_date: "2026-08-21",
category: "software"
})ledger({ action: "summary", months: 1 })Erreurs
- Échec d'autorisation : le jeton ne dispose pas de memory:read pour les lectures ou de memory:write pour les mutations.
- Échec de validation : les champs de transaction requis, formats de date, devise ou valeurs d'action sont invalides.
- Échec de concurrence : une mise à jour comporte un expected_version obsolète ou la transaction exacte est introuvable.
- Limite d'agrégation : les enregistrements dans des devises différentes sont signalés séparément au lieu de produire un faux total combiné.
Outils associés
Source : Référence MCP