evaluate_purchase
Weighs a purchase, loan, or savings goal against a family's real finances—savings, cash flow, debts, emergency fund, goals, and stress-test risk—to show affordability and up to three alternatives.
Instructions
Weighs a purchase against the family's real numbers: what it does to the savings, what is left for living, the loan payment share, the emergency fund and the goals, the stress test, the risk and up to three alternatives. Required by kind: buy_now (own money) — amount, currency; optional goalId when the money was put aside for that goal. credit — amount, currency, termMonths, ratePct, downPayment (in the same currency, below the amount; 0 for none) and loanType. save_up — amount, currency, targetMonth (YYYY-MM, after this month); its goals entry proposed carries requiredMonthly, firstShare and, when nearer goals take savings ahead of it, takenAhead, as in evaluate_goal. A missing required field answers 400 missing_param naming it: ask the family for it, never guess. Every figure is computed by the server in the family currency. Follow answerRules in your answer.
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": {
"kind": "<kind>",
"amount": "<amount>",
"currency": "<currency>"
},
"name": "evaluate_purchase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| amount | Yes | The price, in `currency` | |
| goalId | No | buy_now only: the id of the goal the money was put aside for (from get_family_overview) | |
| ratePct | No | credit: the yearly interest rate, % | |
| currency | Yes | ISO 4217 code of the amount, three capital letters, e.g. USD | |
| loanType | No | credit: the kind of loan | |
| termMonths | No | credit: the term in months | |
| downPayment | No | credit: paid at once, in `currency`, below the amount | |
| targetMonth | No | save_up: the month the money is needed, YYYY-MM |