add_spending_category
Create a spending or income category with its flow and kind when no existing one fits. Use it to add a missing budget category before recording expenses or income.
Instructions
Adds a new category. Call it only when no existing category fits, and tell the user which category you are creating. flow: expense (the default), active income (salary, business, a bonus) or passive income (dividends, coupons, interest, rent, benefits); it cannot be changed later. An expense category needs kind: mandatory (housing, utilities, food, insurance) or optional; an income one takes no kind and may be oneOff (a bonus, a tax refund). A name that exists in any letter case is refused with 409 category_exists: use the existing category instead.
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": {
"name": "<name>"
},
"name": "add_spending_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | The total the category allocates; default expense | |
| kind | No | Only for an expense category, and needed there | |
| name | Yes | The category's name | |
| oneOff | No | Only for an income category: income not expected every month |