Funktionen

avenir-mcp gibt einem Agenten 25 Tools, 4 Ressourcen und 4 Prompts für Ihre YNAB-Plans. Diese Seite ordnet sie nach dem, was Sie tun möchten. Jede Zeile nennt einen Satz, den Sie dem Agenten sagen können; der Agent wählt das Tool.

Hinweis

L = nur lesend, immer verfügbar. S = schreibend, verfügbar mit AVENIR_MCP_WRITE=1, als Vorschau gezeigt und bestätigt. ↺ = mit undo_operation rückgängig zu machen.

Plan oder Budget?

YNAB nennt ein Budget jetzt plan, und die Tools von avenir-mcp ebenso (list_plans, plan_id). Sagen Sie, was Ihnen lieber ist: Der Agent versteht beides und antwortet mit Ihrem Wort. „Mein Budget für Restaurants“ meint weiterhin den Betrag, der dieser Kategorie zugewiesen ist.

Sich umsehen

Sie sagen	Tool
„Welche Plans habe ich?“	list_plans	L
„Was ist auf meinen Konten?“	list_accounts	L
„Warum kommen meine Bankbuchungen nicht mehr an?“	list_accounts – die Verbindung jedes Kontos zur Bank (aktiv, gestört, keine) und der letzte Abgleich	L
„Welche Kategoriegruppen gibt es?“	list_category_groups	L
„Welche Transaktion ist mein Beleg über 86,40 vom 12.?“	find_transactions – nach Datum, genauem Betrag und Konto, kategorisiert oder nicht	L
„Wodurch ist Restaurants diesen Monat überzogen?“	find_transactions – nach Kategorie, aufgeteilte Zeilen eingeschlossen, oder nach Empfänger, egal wie die Bank ihn bezeichnet	L
„Welche Rechnungen sind vor dem 10. fällig?“	list_scheduled_transactions – geplante Transaktionen in ihrem Rhythmus wiederholt, Ein- und Ausgänge	L
„Was habe ich abonniert, und was kostet es im Jahr?“	find_recurring_charges – Ausgaben, die fast jeden Monat vorkommen, die im Jahr teuersten zuerst	L

Plans, Konten und Kategorien werden auch als Ressourcen bereitgestellt, die Ihr Client ohne Tool-Aufruf an ein Gespräch anhängen kann.

Einen Monat verstehen

Sie sagen	Tool
„Wie läuft der September?“	get_monthly_summary – Einnahmen, budgetiert, ausgegeben, Ready to Assign, überzogene Kategorien	L
„Zeig mir jede Kategorie.“	get_category_balances – budgetiert, ausgegeben, verfügbar je Kategorie	L
„Welche Budgets sind fast aufgebraucht?“	get_budget_vs_actual – verbrauchter Anteil jedes Budgets	L
„Ist Restaurants jeden Monat hoch?“	get_spending_trends – Ausgaben je Kategorie über N Monate	L

Anleitung: Einen Monat auswerten.

Transaktionen kategorisieren

Sie sagen	Tool
„Hol die neuesten Transaktionen meiner Bank.“	import_transactions – was Import in YNAB tut, sofort angewendet	S
„Was braucht noch eine Kategorie?“	suggest_categories – ausstehende Transaktionen, mit Vorschlag, wenn Ihre Historie eindeutig ist	L
„Ja, wende das an.“	apply_categories – ein bestätigter Stapel	S ↺
„Markiere die Buchungen, die ich in YNAB prüfen sollte.“	flag_transactions – eine farbige Markierung, in YNAB anzusehen	S ↺
„Teile diesen Beleg auf: 81,15 Lebensmittel, 5,25 Haushalt.“	split_transaction – eine Transaktion auf mehrere Kategorien; in YNAB rückgängig zu machen, nicht hier	S
„Markiere sie als geprüft.“	approve_transactions – entfernt YNABs Kennzeichen unapproved	S

Vorschläge erkennen einen Händler über seine Bankbezeichnungen hinweg (CB MARKET FRESH FACT 050926 525130******1 und … 190926 … sind derselbe Laden), lernen Ein- und Ausgänge getrennt und verweisen nie auf eine ausgeblendete Kategorie. Anleitung: Ausstehende Transaktionen kategorisieren. Wie es funktioniert: Vorschläge.

Mit der Bank vergleichen

Sie sagen	Tool
„Meine Bank zeigt 3.440,80. Stimmt YNAB damit überein?“	reconcile_account – erklärt eine Differenz, ohne zu schreiben; gleicht ab, sobald es passt	S ↺
„Füge die Apothekenzahlung hinzu, die der Import verpasst hat.“	create_transactions	S ↺

Eine Differenz wird erklärt durch ausstehende Transaktionen, diejenige, deren Betrag der Differenz entspricht, und wahrscheinliche Duplikate (gleicher Betrag und Händler, höchstens 3 Tage auseinander). Anleitungen: Ein Konto abgleichen, Fehlende Transaktionen ergänzen.

Planen

Sie sagen	Tool
„Rutsche ich vor Dezember unter null?“	forecast_balance – Monat für Monat, mit seinen Annahmen	L
„Setz Restaurants für September auf 150.“	set_category_budget	S ↺
„Schichte 30 von Tennis nach Restaurants um.“	move_money – beide Kategorien in einer Bestätigung	S ↺

Die Prognose setzt die geplanten Transaktionen von YNAB auf ihre Termine, findet wiederkehrende Belastungen in Ihrer Historie, mittelt den Rest und lässt Sie Ihr Einkommen und einmalige Beträge angeben. Anleitung: Vorausplanen. Wie es funktioniert: Prognose.

Kategorien ordnen

Sie sagen	Tool
„Leg eine Kategorie Haustiere in der Gruppe Alltag an.“	create_category	S
„Benenne Tennis in Sport um.“	update_category – verschiebt eine Kategorie auch in eine andere Gruppe	S
„Spare bis Juni 2027 1.200 für den Urlaub.“	set_category_target – ein Betrag bis zu einem Datum oder jeden Monat, jede Woche, jedes Jahr	S ↺

Anleitung: Kategorien ordnen.

Rückgängig machen

Sie sagen	Tool
„Mach das rückgängig.“	undo_operation – die letzte Operation oder die genannte	S

Anleitung: Eine Änderung rückgängig machen. Wie es funktioniert: Journal und Rückgängig.

Fertige Abläufe

Vier Prompts führen den Agenten durch eine ganze Aufgabe. In Claude Code sind es Slash-Befehle des Servers avenir-mcp.

Prompt	Argumente	Was er tut
classify_pending	Plan	Vorschläge, Ihre Entscheidungen, ein bestätigter Stapel, die ID zum Rückgängigmachen
monthly_review	Plan, Monat	Summen, was auffällt, vorgeschlagene Korrekturen
reconcile	Plan, Konto, Kontostand der Bank	die Differenz erklärt, dann ein bestätigter Abgleich
plan_next_month	Plan	Prognose und Annahmen, dann die Beträge des nächsten Monats

Eingebaut

• Sicherheit: standardmäßig nur lesend, Bestätigung an die genaue Vorschau gebunden, ein lokales Journal zum Rückgängigmachen, Banktexte als nicht vertrauenswürdig behandelt. Siehe Sicherheit durch Design.
• Sparsamkeit: eine lokale Kopie Ihrer Transaktionen, per Delta-Synchronisation aktualisiert; die meisten Tools kosten eine oder zwei YNAB-Anfragen. Siehe Daten und Synchronisation.
• Klarheit für Agenten: Währungseinheiten, typisierte Ausgabeschemas mit einer Beschreibung je Feld, Paginierung, Fehler, die sagen, was zu tun ist.
• Protokoll: MCP 2026-07-28 und frühere Versionen; stdio oder Streamable HTTP.