Mark handled
mark_handledRecord when a recurring or one-off bill, renewal, or subscription is paid, renewed, switched, or replaced; log it in history and advance or clear the due date, including cost changes.
Instructions
Record that the user has dealt with an item (renewed, paid, switched, replaced). Logs it in the item's history and moves the due date on: repeating items roll forward by their period (keeping month-end dates right), next_due sets a date explicitly, and a one-off item's due date is cleared. Pass new_cost when the price changed; the old and new prices are logged.
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": {
"item": "<item>"
},
"name": "mark_handled"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes | The item's title | |
| note | No | What was done, e.g. 'Renewed with Admiral after haggling' | |
| new_cost | No | The new cost per period, if it changed | |
| next_due | No | Set the next due date explicitly (YYYY-MM-DD) |