Age of Money month by month
get_age_of_moneyShows YNAB's Age of Money in days month by month, with the latest figure, change and direction, so you can see whether your buffer is growing or you're living on last month's income.
Instructions
YNAB's Age of Money: how old the money spent is today, and its trend month by month.
Use it for "how old is my money?", "am I living on last month's income?" or "is my buffer growing?". The figure is YNAB's own, in days: how long, on average, money stayed in the budget accounts before being spent, the oldest money spent first. Over 30 days means living on last month's income. months_count counts back from the current month, included, so 1 gives this month alone and the default 12 the year up to it; a plan that holds fewer months gives those, and says so in the notes. The answer gives each month's figure, the latest, the change and its direction over the period. A month YNAB had not enough history for comes back null, not as an error, and the notes name those months. Relay the notes with the figures. For how long the money would last without income use get_runway. One YNAB request, the list of months; changes nothing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"plan_id": "<plan_id>"
},
"name": "get_age_of_money"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan_id | Yes | YNAB plan id or 'last-used'. | |
| months_count | No | Months to show, the current one included, 1 to 24 (default 12). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | Yes | The latest Age of Money, in days; null when YNAB gives none. | |
| as_of | Yes | The month of that figure, YYYY-MM: the current one unless YNAB has none for it. | |
| notes | Yes | How YNAB counts, and what is missing, to tell the user. | |
| trend | Yes | The direction of that change; null with fewer than two figures. | |
| change | Yes | Days gained (positive) or lost from the first month with a figure to the latest; null with fewer than two figures. | |
| months | Yes | The months up to the current one, oldest first. | |
| message | Yes | The conclusion in one sentence or two, for the agent to relay. |