Fonctionnalités

avenir-mcp donne à un agent 25 outils, 4 ressources et 4 prompts sur vos plans 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 plans ai-je ? »	list_plans	L
« Qu’y a-t-il sur mes comptes ? »	list_accounts	L
« Pourquoi mes opérations bancaires n’arrivent-elles plus ? »	list_accounts — la liaison bancaire de chaque compte (active, en erreur, absente) et son dernier rapprochement	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
« À quoi suis-je abonné, et combien ça coûte par an ? »	find_recurring_charges — les dépenses vues presque chaque mois, les plus chères sur l’année d’abord	L

Plans, 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
« Restaurants est-il élevé 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
« Récupère les dernières transactions de ma banque. »	import_transactions — ce que fait Import dans YNAB, appliqué aussitôt	É
« 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é	É ↺
« Mets un drapeau sur celles que je dois vérifier dans YNAB. »	flag_transactions — un drapeau de couleur, à regarder dans YNAB	É ↺
« 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	É ↺
« Déplace 30 de Tennis vers Restaurants. »	move_money — les deux catégories en une confirmation	É ↺

La prévision 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 : Prévision.

Organiser les catégories

Vous dites	Outil
« Crée une catégorie Animaux dans le groupe Quotidien. »	create_category	É
« Renomme Tennis en Sport. »	update_category — déplace aussi une catégorie vers un autre groupe	É
« Mets de côté 1 200 pour les vacances d’ici juin 2027. »	set_category_target — un montant à une date, ou chaque mois, semaine ou année	É ↺

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	plan	propositions, vos choix, un lot confirmé, l’identifiant pour annuler
monthly_review	plan, mois	les totaux, ce qui ressort, les corrections proposées
reconcile	plan, compte, solde bancaire	l’écart expliqué, puis un rapprochement confirmé
plan_next_month	plan	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.