ClarityTrack

Returns a synthesized financial snapshot: net worth, month-to-date spend vs budget, and active goals. Use this for 'how am I doing?' questions. Figures come back pre-aggregated as chart-ready series, so plotting them needs no client-side math.

summary.financial

Preview a new income, expense, or payment toward a debt. A payment needs the debt name so it can be linked to that debt. This records the transaction inside ClarityTrack. It does not move money. Requires the write scope on this connection. Nothing is saved until actions.commit is called with the returned previewToken after the user confirms.

transactions.log.preview

The one-call monthly dashboard: calculation-complete summary cards (net worth, month-to-date spend, budget status, goals), spending by category, budget variance, recent Clarity insights, coverage and freshness notes, plus a render_spec field. The result is shown to the user as a ClarityTrack card, so the host shouldn't redraw it; render_spec's layout is only for clients that can't show the card. Prefer this over combining other tools for any 'show me my month' or dashboard request. Its figures are final, server-computed values.

dashboard.monthly

Returns your goal scoreboard: each payoff or savings goal, whether it is ahead, on track, behind, or too early to tell, and how fresh the balances are. Same figures as the home scoreboard. Read only. Nothing moves money.

plan.scoreboard

Returns your recent transactions. Accepts optional limit (max 100, default 50), offset, and since (ISO date YYYY-MM-DD). For spending-by-category totals use spending.by_category instead of summing these rows.

transactions.list

Preview switching the payoff strategy between avalanche, which pays the highest interest first, and snowball, which pays the smallest balance first. This changes the saved strategy only. It does not move money, and it does not create a dated payoff plan. Requires the write scope on this connection. Nothing is saved until actions.commit is called with the returned previewToken after the user confirms.

debts.strategy.set.preview

Returns deterministic, server-computed spending totals grouped by category for a date window (defaults to month-to-date). Totals are exact and reconcile with summary.financial's mtd_spend. Use this for 'where is my money going' and category-breakdown questions instead of summing transactions yourself. Returns category labels paired with exact numeric totals, already sorted and pre-aggregated as a chart-ready series.

spending.by_category

Returns this month's spending pace against your plan and against last month, with the cumulative points the pace card draws. Optional month is YYYY-MM. Same figures as the home spending pace card. Read only. Nothing moves money.

spending.pace

Returns recurring subscriptions with your cancellation marks, plus each cancellation request and its stored verdict. confirmed_stopped means the next bill date passed with no charge. charge_detected means a charge posted after the request. committed means it is still waiting, and a missing charge before that date is not a stop. chargedAfterCancellation on a cancelled stream means a charge posted after you marked it cancelled. This is not your ClarityTrack plan tier. That is subscription.status. Read only. Nothing moves money.

subscriptions.follow_through

Returns your ClarityTrack subscription tier and status.

subscription.status

Preview a change to an existing goal's title, target date, or target amount. The goalId is the goalId on a row from plan.scoreboard. It does not move money. Requires the write scope on this connection. Nothing is saved until actions.commit is called with the returned previewToken after the user confirms.

goals.update.preview

Returns the daily snapshot of what changed across your connected accounts since the previous snapshot, including the connected net worth change. Same figures as the home what-changed card. Read only. Nothing moves money.

changes.recent