Functies

avenir-mcp geeft een agent 25 tools, 4 resources en 4 prompts voor je YNAB-plans. Deze pagina ordent ze naar wat je wilt doen. Elke regel geeft een zin die je tegen de agent kunt zeggen; de agent kiest de tool.

Opmerking

L = alleen lezen, altijd beschikbaar. S = schrijven, beschikbaar met AVENIR_MCP_WRITE=1, met voorbeeld en bevestiging. ↺ = ongedaan te maken met undo_operation.

Plan of budget?

YNAB noemt een budget nu een plan, en de tools van avenir-mcp ook (list_plans, plan_id). Zeg wat je wilt: de agent begrijpt beide en antwoordt met jouw woord. „Mijn budget voor Restaurants“ betekent nog steeds het bedrag dat aan die categorie is toegewezen.

Rondkijken

Je zegt	Tool
„Welke plans heb ik?“	list_plans	L
„Wat staat er op mijn rekeningen?“	list_accounts	L
„Waarom komen mijn banktransacties niet meer binnen?“	list_accounts – de bankkoppeling van elke rekening (actief, in fout, geen) en de laatste afstemming	L
„Welke categoriegroepen zijn er?“	list_category_groups	L
„Welke transactie is mijn bon van 86,40 van de 12e?“	find_transactions – op datum, exact bedrag en rekening, gecategoriseerd of niet	L
„Waardoor zit Restaurants deze maand over budget?“	find_transactions – op categorie, gesplitste regels inbegrepen, of op begunstigde, hoe de bank hem ook noemt	L
„Welke facturen moeten vóór de 10e betaald worden?“	list_scheduled_transactions – geplande transacties herhaald volgens hun frequentie, inkomend en uitgaand	L
„Waar ben ik op geabonneerd, en wat kost het per jaar?“	find_recurring_charges – uitgaven die bijna elke maand terugkomen, de duurste per jaar eerst	L

De plans, rekeningen en categorieën worden ook aangeboden als resources die je client zonder toolaanroep aan een gesprek kan koppelen.

Een maand begrijpen

Je zegt	Tool
„Hoe gaat september?“	get_monthly_summary – inkomsten, gebudgetteerd, uitgegeven, Ready to Assign, categorieën over budget	L
„Laat me elke categorie zien.“	get_category_balances – gebudgetteerd, uitgegeven, beschikbaar per categorie	L
„Welke budgetten zijn bijna op?“	get_budget_vs_actual – verbruikt deel van elk budget	L
„Is Restaurants elke maand hoog?“	get_spending_trends – uitgaven per categorie over N maanden	L

Handleiding: Een maand doornemen.

Transacties categoriseren

Je zegt	Tool
„Haal de nieuwste transacties van mijn bank op.“	import_transactions – wat Import in YNAB doet, meteen toegepast	S
„Wat heeft nog een categorie nodig?“	suggest_categories – openstaande transacties, met een suggestie als je geschiedenis duidelijk is	L
„Ja, pas dat toe.“	apply_categories – één bevestigde batch	S ↺
„Zet een vlag op de transacties die ik in YNAB moet nakijken.“	flag_transactions – een gekleurde vlag, om in YNAB te bekijken	S ↺
„Splits deze bon: 81,15 boodschappen, 5,25 huishouden.“	split_transaction – één transactie over meerdere categorieën; ongedaan te maken in YNAB, niet hier	S
„Markeer ze als gecontroleerd.“	approve_transactions – haalt de markering unapproved van YNAB weg	S

Suggesties herkennen een winkelier over zijn bankomschrijvingen heen (CB MARKET FRESH FACT 050926 525130******1 en … 190926 … zijn dezelfde winkel), leren inkomend en uitgaand geld apart, en wijzen nooit naar een verborgen categorie. Handleiding: Openstaande transacties categoriseren. Hoe het werkt: Suggesties.

Vergelijken met de bank

Je zegt	Tool
„Mijn bank toont 3.440,80. Is YNAB het daarmee eens?“	reconcile_account – legt een verschil uit zonder te schrijven; stemt af zodra het klopt	S ↺
„Voeg de apotheekbetaling toe die de import heeft gemist.“	create_transactions	S ↺

Een verschil wordt verklaard door openstaande transacties, de transactie waarvan het bedrag gelijk is aan het verschil, en waarschijnlijke dubbele boekingen (zelfde bedrag en winkelier, hooguit 3 dagen uit elkaar). Handleidingen: Een rekening afstemmen, Ontbrekende transacties toevoegen.

Plannen

Je zegt	Tool
„Kom ik vóór december onder nul?“	forecast_balance – maand voor maand, met zijn aannames	L
„Zet Restaurants voor september op 150.“	set_category_budget	S ↺
„Verschuif 30 van Tennis naar Restaurants.“	move_money – beide categorieën in één bevestiging	S ↺

De prognose zet de geplande transacties van YNAB op hun data, vindt terugkerende kosten in je geschiedenis, middelt de rest en laat je je inkomen en eenmalige bedragen opgeven. Handleiding: Vooruit plannen. Hoe het werkt: Prognose.

Categorieën ordenen

Je zegt	Tool
„Maak een categorie Huisdieren in de groep Dagelijks.“	create_category	S
„Hernoem Tennis naar Sport.“	update_category – verplaatst een categorie ook naar een andere groep	S
„Spaar 1.200 voor de vakantie vóór juni 2027.“	set_category_target – een bedrag vóór een datum, of elke maand, week of elk jaar	S ↺

Handleiding: Categorieën ordenen.

Ongedaan maken

Je zegt	Tool
„Maak dat ongedaan.“	undo_operation – de laatste operatie, of de genoemde	S

Handleiding: Een wijziging ongedaan maken. Hoe het werkt: Journaal en ongedaan maken.

Kant-en-klare werkstromen

Vier prompts leiden de agent door een hele taak. In Claude Code zijn het slash-commando’s van de server avenir-mcp.

Prompt	Argumenten	Wat hij doet
classify_pending	plan	suggesties, jouw keuzes, één bevestigde batch, het id om ongedaan te maken
monthly_review	plan, maand	totalen, wat opvalt, voorgestelde correcties
reconcile	plan, rekening, banksaldo	het verschil uitgelegd, dan een bevestigde afstemming
plan_next_month	plan	prognose en aannames, dan de bedragen van volgende maand

Ingebouwd

• Veiligheid: standaard alleen lezen, bevestiging gekoppeld aan het exacte voorbeeld, een lokaal journaal om ongedaan te maken, banktekst als onbetrouwbaar behandeld. Zie Veilig door ontwerp.
• Zuinigheid: een lokale kopie van je transacties, bijgewerkt met delta-synchronisatie; de meeste tools kosten één of twee YNAB-verzoeken. Zie Gegevens en synchronisatie.
• Duidelijkheid voor agents: valuta-eenheden, getypeerde uitvoerschema’s met een beschrijving per veld, paginering, fouten die zeggen wat je moet doen.
• Protocol: MCP 2026-07-28 en eerdere versies; stdio of streamable HTTP.