plan_monthly_budget
Builds a monthly budget from a list of expenses at any frequency: normalises everything to a monthly basis, tiers each item (T1 fixed essentials, T2 variable essentials, T3 lifestyle, T4 discretionary), and returns cash-basis disposable income, savings rate after expenses and investments, the biggest optimisable leak and a surplus projection; deficit months clamp savings at zero. Use to summarize a household's actual monthly net income and expense items. Ask for the actual expense ledger or item amounts; never fabricate expenses. Entries without a frequency are treated as monthly and disclosed. Omitted investment contributions are treated as zero and disclosed.
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": {
"monthlyNetIncome": "<monthlyNetIncome>",
"expenses": "<expenses>"
},
"name": "plan_monthly_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expenses | Yes | Expense items. Known catalogue keys (mortgageRent, groceries, netflix, fuel, ...) are tiered automatically; otherwise pass an explicit tier. | |
| projectionYears | No | Horizon of the surplus projection (default 10). | |
| monthlyNetIncome | Yes | Take-home monthly income, EUR (net of tax, social insurance and GESY); zero is valid but savings rate is unavailable. | |
| targetSavingsRate | No | Savings-rate goal as a percent of net income. | |
| monthlyInvestments | No | Recurring monthly investments/savings, EUR. | |
| expectedAnnualReturn | No | Assumed annual return on invested surplus, percent (default 0). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series | No | ||
| projection | Yes | ||
| savingsGap | Yes | ||
| tierTotals | Yes | ||
| assumptions | Yes | ||
| largestLeak | Yes | ||
| savingsRate | Yes | ||
| annualExpenses | Yes | ||
| categoryTotals | Yes | ||
| monthlySurplus | Yes | ||
| disposableIncome | Yes | ||
| monthlyNetIncome | Yes | ||
| targetSavingsRate | Yes | ||
| discretionaryTotal | Yes | ||
| monthlyInvestments | Yes | ||
| targetMonthlySavings | Yes | ||
| totalMonthlyExpenses | Yes | ||
| currentMonthlySavings | Yes | ||
| totalMonthlyOutgoings | Yes |