save_category_spending
Records or replaces a non-account card or cash source's monthly spending by expense category for an already closed month; send the full statement at once.
Instructions
Saves a free source's spending by category (a card or cash that is not an account; for an account use save_account_lines) for a month BEFORE the first open month of the wizard queue (an earlier, already closed month). For the first open month use preview_statement / commit_statement; this tool refuses that month and later ones with 409 advisor.use_statement_tools. Expense categories only (invalid_category_flow otherwise). It REPLACES everything that source already had for that month (other sources stay), so send the whole statement at once; an empty items list removes the source's month. month is YYYY-MM, not later than the last finished month. source names the card or the cash. Each item is the month's total for one category in one currency (one item per category and currency); categoryId comes from list_spending_categories. Confirm the numbers with the user before saving.
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": {
"month": "<month>",
"source": "<source>",
"items": "<items>"
},
"name": "save_category_spending"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| month | Yes | The statement's month, YYYY-MM | |
| source | Yes | The statement's source, e.g. a bank or a card |