get_budget_vs_actual
Qué hace
Sección titulada «Qué hace»Share of each category’s budget spent in a month, to see what is over or close.
Use it for “am I over budget?” or “which categories are nearly used up?”. Give month as the first day of a month, YYYY-MM-01; any other day is refused. ‘current’ is the month in progress, where a share under 100 may only mean the month is not over. Amounts in currency units, spending as a positive number; utilization_pct above 100 means over budget. carried_over says what the months before left in the category, so budgeted plus carried_over is what the month had to spend: a category can be over its budget and still have something left. For what is still available in each category use get_category_balances; for the month’s totals, get_monthly_summary; for the months before, get_spending_trends. One YNAB request; changes nothing.
Comportamiento
Sección titulada «Comportamiento»| Tipo | solo lectura |
| Confirmación | no |
| Deshacer | no |
| Idempotente | sí |
| Peticiones a YNAB | 1 para el ejemplo de abajo, con la caché vacía |
Parámetros
Sección titulada «Parámetros»| Nombre | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|
plan_id |
string | sí | — | YNAB plan id or ‘last-used’. |
month |
string | no | "current" |
ISO month ‘YYYY-MM-01’ or ‘current’. |
Devuelve
Sección titulada «Devuelve»array of object
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | YNAB id of the category. |
name |
string | Category name. |
group |
string | Name of the category’s group, e.g. Fun for Tennis. |
budgeted |
number | Amount assigned to the category this month. |
carried_over |
number | What the months before left available in the category when this one started; zero when the category started the month on nothing. |
actual |
number | Amount spent this month, as a positive number. |
balance |
number | What is left: budgeted minus spent, plus what was carried over; negative when overspent. |
utilization_pct |
number | Spent as a share of budgeted, in percent; above 100 means overspent, 0 when nothing is budgeted. |
Ejemplo
Sección titulada «Ejemplo»Argumentos:
{ "plan_id": "demo-budget", "month": "2026-09-01"}Respuesta sobre el presupuesto de demostración:
[ { "id": "cat-rent", "name": "Alquiler", "group": "Facturas", "budgeted": 950.0, "carried_over": 0.0, "actual": 950.0, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-power", "name": "Luz", "group": "Facturas", "budgeted": 64.2, "carried_over": 0.0, "actual": 64.2, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-internet", "name": "Fibra", "group": "Facturas", "budgeted": 29.99, "carried_over": 0.0, "actual": 29.99, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-phone", "name": "Teléfono", "group": "Facturas", "budgeted": 19.99, "carried_over": 0.0, "actual": 19.99, "balance": 0.0, "utilization_pct": 100.0 }, "… 8 more"]Errores
Sección titulada «Errores»month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.
Los errores propios de YNAB llegan como Error calling tool '<tool>': YNAB <status>: <detail>.
Ver también
Sección titulada «Ver también»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