Ir al contenido

Herramientas

avenir-mcp declara estas herramientas. Las de lectura están siempre disponibles; las de escritura solo existen con AVENIR_MCP_WRITE=1, y todas salvo approve_transactions se previsualizan y se confirman.

Herramienta Resumen
find_recurring_charges List the subscriptions and other charges paid every month, with their yearly cost.
find_transactions Find transactions by date, amount, account, category or payee, categorised or not.
forecast_balance Project the balance month by month and say when money would run out.
get_age_of_money YNAB’s Age of Money: how old the money spent is today, and its trend month by month.
get_budget_vs_actual Share of each category’s budget spent in a month, to see what is over or close.
get_category_balances Budgeted, spent (activity) and available (balance) per category for a month.
get_debt_payoff_plan When the debts would be paid off, highest rate first (avalanche) or smallest first.
get_monthly_summary A month at a glance: income, budgeted, spent, Ready to Assign, overspent categories.
get_net_worth_trend Assets, debts and net worth at the end of each month, to see debts go down.
get_runway How many months the money available would last without income, at the usual spending.
get_savings_rate How much of the income was kept, month by month: income, spending, saved, rate.
get_spending_trends Spending per category, month by month, over the last N months.
get_underfunded_targets The categories whose target still needs money this month, the most urgent first.
list_accounts List the plan’s accounts with their balances, bank link and last reconciliation.
list_category_groups List the category groups a category can be created in or moved to.
list_payees List the payees of a plan, those most transactions name first.
list_plans List all YNAB plans accessible with the current API key.
list_scheduled_transactions List the scheduled transactions due between two dates: bills, salary, transfers.
suggest_categories List the transactions waiting for a category, with a suggestion when history allows.
Herramienta Resumen
apply_categories Assign categories to transactions, after the user confirms, and journal it for undo.
approve_transactions Mark transactions as approved, i.e. reviewed (clears YNAB’s “unapproved” badge).
create_category Create a category in a group, after the user confirms.
create_transactions Create transactions on an account, e.g. ones the bank import missed, after the user confirms.
flag_transactions Set or remove the coloured flag of transactions, after the user confirms.
move_money Move money budgeted in one category to another for a month, after the user confirms.
reconcile_account Compare an account with the balance your bank shows, then reconcile it.
rename_payee Rename a payee, e.g. a bank label into the merchant’s name, after the user confirms.
set_category_budget Set the amount budgeted (“Assigned”) in a category for a month, after the user confirms.
set_category_target Set, change or remove a category’s target, after the user confirms.
split_transaction Split one transaction across categories, e.g. from a receipt, after the user confirms.
undo_operation Undo an operation made through this server: the latest one, or the one named.
update_category Rename a category and/or move it to another group, after the user confirms.
URI Descripción
avenir-mcp://guide How to use this server’s tools, and the YNAB method in brief.
ynab://plans The plans (budgets) the token can read, with the ids tools need.
ynab://plans/{plan_id}/categories A plan’s assignable categories by group, with their ids.
ynab://plans/{plan_id}/accounts A plan’s open accounts, balances in currency units.
Prompt Argumentos Descripción
classify_pending plan_id Classify the transactions waiting for a category.
monthly_review plan_id, month (opcional) Review a month of a plan: where the money went and what needs attention.
reconcile plan_id, account_id, bank_balance Reconcile an account with the balance the bank shows.
plan_next_month plan_id Prepare next month’s category amounts from the forecast and this month’s categories.

Proyecto no oficial. «We are not affiliated, associated, or in any way officially connected with YNAB or any of its subsidiaries or affiliates. The official YNAB website can be found at https://www.ynab.com. The names YNAB and You Need A Budget, as well as related names, tradenames, marks, trademarks, emblems, and images are registered trademarks of YNAB.» No estamos afiliados, asociados ni conectados oficialmente de ninguna manera con YNAB ni con sus filiales o empresas afiliadas. El sitio web oficial de YNAB se encuentra en https://www.ynab.com. Los nombres YNAB y You Need A Budget, así como los nombres, nombres comerciales, marcas, emblemas e imágenes relacionados, son marcas registradas de YNAB. avenir-mcp se ofrece tal cual, sin garantía, y no es asesoramiento financiero. Aviso legal · Privacidad