Fonctionnalités

avenir-mcp donne à un agent 20 outils, 4 ressources et 4 prompts sur vos budgets YNAB. Cette page les classe selon ce que vous voulez faire. Chaque ligne donne une phrase à dire à l’agent ; c’est lui qui choisit l’outil.

Note

L = lecture seule, toujours disponible. É = écriture, disponible avec AVENIR_MCP_WRITE=1, prévisualisée et confirmée. ↺ = annulable avec undo_operation.

Plan ou budget ?

YNAB appelle désormais un budget un plan, et les outils d’avenir-mcp aussi (list_plans, plan_id). Dites le mot que vous préférez : l’agent comprend les deux et vous répond avec le vôtre. « Mon budget restaurants » désigne toujours le montant attribué à cette catégorie.

Faire le tour

Vous dites	Outil
« Quels budgets ai-je ? »	list_plans	L
« Qu’y a-t-il sur mes comptes ? »	list_accounts	L
« Quels groupes de catégories existent ? »	list_category_groups	L
« Quelle transaction correspond à mon ticket de 86,40 du 12 ? »	find_transactions — par dates, montant exact et compte, catégorisée ou non	L
« Qu’est-ce qui a fait dépasser Restaurants ce mois-ci ? »	find_transactions — par catégorie, lignes ventilées comprises, ou par bénéficiaire, quel que soit le libellé bancaire	L
« Quelles factures tombent avant le 10 ? »	list_scheduled_transactions — les transactions planifiées répétées à leur fréquence, avec l’argent qui entre et qui sort	L

Budgets, comptes et catégories sont aussi servis comme ressources, que votre client peut joindre à une conversation sans appel d’outil.

Comprendre un mois

Vous dites	Outil
« Comment se passe septembre ? »	get_monthly_summary — revenus, budgété, dépensé, Ready to Assign, catégories en dépassement	L
« Montre-moi toutes les catégories. »	get_category_balances — budgété, dépensé, disponible par catégorie	L
« Quels budgets sont presque épuisés ? »	get_budget_vs_actual — part de chaque budget consommée	L
« Les restaurants sont-ils élevés tous les mois ? »	get_spending_trends — dépenses par catégorie sur N mois	L

Guide : Faire le point sur un mois.

Classer les transactions

Vous dites	Outil
« Qu’est-ce qui attend une catégorie ? »	suggest_categories — transactions en attente, avec une proposition quand votre historique est clair	L
« Oui, applique. »	apply_categories — un lot confirmé	É ↺
« Ventile ce ticket : 81,15 en courses, 5,25 en entretien. »	split_transaction — une transaction sur plusieurs catégories ; s’annule dans YNAB, pas ici	É
« Marque-les comme revues. »	approve_transactions — lève le marqueur unapproved de YNAB	É

Les propositions reconnaissent un commerçant à travers ses libellés bancaires (CB MARKET FRESH FACT 050926 525130******1 et … 190926 … sont la même boutique), apprennent séparément les entrées et les sorties d’argent, et ne proposent jamais de catégorie masquée. Guide : Classer les transactions en attente. Fonctionnement : Suggestions.

Vérifier avec la banque

Vous dites	Outil
« Ma banque affiche 3 440,80. YNAB est-il d’accord ? »	reconcile_account — explique un écart sans rien écrire ; rapproche une fois d’accord	É ↺
« Ajoute le paiement de la pharmacie que l’import a manqué. »	create_transactions	É ↺

Un écart s’explique par les transactions en attente, celle dont le montant égale la différence, et les doublons probables (même montant et même commerçant, à 3 jours au plus). Guides : Rapprocher un compte, Ajouter des transactions manquantes.

Anticiper

Vous dites	Outil
« Vais-je passer sous zéro avant décembre ? »	forecast_balance — mois par mois, avec ses hypothèses	L
« Mets 150 dans Restaurants pour septembre. »	set_category_budget	É ↺

La projection place les transactions planifiées de YNAB à leurs dates, repère les charges récurrentes de votre historique, fait la moyenne du reste, et vous laisse indiquer revenus et montants ponctuels. Guide : Anticiper. Fonctionnement : Projection.

Organiser les catégories

Vous dites	Outil
« Crée une catégorie Pets dans Everyday. »	create_category	É
« Renomme Tennis en Sport. »	update_category — déplace aussi une catégorie vers un autre groupe	É

Guide : Organiser les catégories.

Annuler

Vous dites	Outil
« Annule ça. »	undo_operation — la dernière opération, ou celle désignée	É

Guide : Annuler un changement. Fonctionnement : Journal et annulation.

Procédures toutes prêtes

Quatre prompts guident l’agent dans une tâche complète. Dans Claude Code, ce sont des commandes slash du serveur avenir-mcp.

Prompt	Arguments	Ce qu’il fait
classify_pending	budget	propositions, vos choix, un lot confirmé, l’identifiant pour annuler
monthly_review	budget, mois	les totaux, ce qui ressort, les corrections proposées
reconcile	budget, compte, solde bancaire	l’écart expliqué, puis un rapprochement confirmé
plan_next_month	budget	projection et hypothèses, puis les montants du mois suivant

Intégré

• Sécurité : lecture seule par défaut, confirmation liée à l’aperçu exact, journal local pour annuler, texte bancaire traité comme non fiable. Voir Sécurité par conception.
• Économie : une copie locale des transactions mise à jour par synchronisation incrémentale ; la plupart des outils coûtent une ou deux requêtes YNAB. Voir Données et synchronisation.
• Clarté pour les agents : unités monétaires, schémas de sortie typés avec une description par champ, pagination, erreurs exploitables.
• Protocole : MCP 2026-07-28 et versions antérieures ; stdio ou HTTP streamable.