Simply Family Budget

Soft-delete a transaction. Its allocations and history are retained for recovery through restore_transaction. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

delete_transaction

Remove all allocations from a receipt. The entire parent amount returns to its original category; the parent transaction is retained. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

delete_transaction_splits

Retrieve every field needed for a full recurrence update by exact recurrence_id. Use list_recurrences first to discover the ID. Preserve fields the user did not ask to change.

get_recurrence

Retrieve every field needed for a full transaction update by exact transaction_id. Use search_transactions first to discover the ID. Preserve fields the user did not ask to change.

get_transaction

Read transaction versions and snapshot availability. Legacy versions have no complete allocation snapshot; never infer their allocations. Use exact IDs from discovery tools.

get_transaction_history

Read the receipt's full category breakdown, including its original-category remainder. Only expense/income transactions can be split. Each allocation needs a distinct active category matching the parent type and family, different from the original category. Positive integer cents only. The allocation total must be less than the parent amount; the positive remainder stays in its original category. Use exact IDs from discovery tools.

get_transaction_splits

Returns family profile, currency, timezone, account balances, and a short projection summary.

get_household_overview

Discover exact budget IDs, periods, category IDs, and budget configuration before updating budgets.

list_budgets

Discover exact category IDs and display names before writing. Requires exact IDs for write tools.

list_categories

Discover exact recurrence IDs and schedule details before updating recurring financial data.

list_recurrences

Discover exact tag IDs and display names before writing transactions or recurrences with tags.

list_tags

Discover exact wallet IDs, names, types, and balance configuration before creating transactions or recurrences, selecting transfer destinations, or updating wallets.

list_wallets

Returns daily projected balance points for a single account over a future date range.

get_projected_balance

Set a wallet/account to its observed real balance by recording a signed balance-only reconciliation. Use list_wallets to discover the exact wallet_id. actual_balance_cents may be negative. The adjustment changes wallet balances and projections, but is not an income, expense, transfer, budget item, or report transaction. Use an idempotency_key when a retry may be needed. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

reconcile_wallet_balance

Restore a soft-deleted transaction and its existing allocations. Use search_transactions with include_deleted=true to find it. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

restore_transaction

Restore a selected version. snapshot restores the full recorded parent, tags and allocations, and requires snapshot_available=true. recorded_fields restores only historical scalar fields and preserves current tags and allocations. Read history before selecting a mode and version. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

restore_transaction_version

Restore an archived wallet. Use list_wallets with archived=true or all to discover its ID. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

restore_wallet

Search family transactions by date range, accounts, categories, and free text using cursor pagination.

search_transactions

Update an existing real budget. Use list_budgets first unless an exact budget_id is already known. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_budget

Update existing category metadata. Use list_categories to discover the exact category_id. Updates may affect how existing data is displayed or grouped. Do not use for delete/archive actions. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_category

Update an existing recurrence affecting future scheduled/planned financial data. Use list_recurrences to discover recurrence_id, then get_recurrence to retrieve every current field before updating. Use list_wallets, list_categories, and list_tags for changed related IDs. This is a full recurrence update shape; preserve existing schedule values and do not guess missing fields. Use YYYY-MM-DD from 2000-01-01 through 2100-12-31 for start_on, end_on, next_run_on, and anchor_date. Use month_and_day as MM-DD, for example 01-15. For semi_monthly_days, pass exactly two integers from 1 to 31, for example [1, 15]. For weekly, start_on is enough. For bi_weekly, anchor_date is optional and defaults from start_on. For semi_monthly, semi_monthly_days is optional and defaults from start_on. For monthly, day_of_month is optional and defaults from start_on. For quarterly, day_of_quarter is optional and defaults from start_on. For yearly, month_and_day is optional and defaults from start_on. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_recurrence

Update existing tag metadata. Use list_tags to discover the exact tag_id. Updates may affect how existing data is displayed or grouped. Do not use for delete actions. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_tag

Update an existing real transaction. Use search_transactions to discover transaction_id, then get_transaction to retrieve every current field before updating. Use list_wallets, list_categories, and list_tags for changed related IDs. This is a full transaction update shape; preserve existing values and do not guess missing fields. Use occurred_at as an ISO 8601 date-time with timezone, for example 2026-07-23T14:30:00Z or 2026-07-23T10:30:00-04:00. The backend accepts only instants whose date in the family timezone is from 2000-01-01 through 2100-12-31. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_transaction

Create or replace the COMPLETE allocation list. First read get_transaction_splits; retain every allocation the user wants to keep. Remove one allocation by sending the remaining list. Use delete_transaction_splits to remove all. Only expense/income transactions can be split. Each allocation needs a distinct active category matching the parent type and family, different from the original category. Positive integer cents only. The allocation total must be less than the parent amount; the positive remainder stays in its original category. Use exact IDs from discovery tools. This modifies real family budgeting data; preserve values the user did not ask to change.

update_transaction_splits

Update an existing wallet/account. Use list_wallets to discover the exact wallet_id and current configuration. Wallet updates should not substitute for transaction corrections. This tool modifies real user budgeting data. Use exact IDs only; never invent IDs. Resolve names or descriptions through discovery/search tools first. Amounts are integer cents. Laravel validates authorization, family scoping, policies, balances, observers, logs, duplicate checks, conflicts, and persistence. Ask for clarification before writing when intent is ambiguous. Do not use this tool for delete, archive, restore, pause, resume, materialize, or other lifecycle actions.

update_wallet