Kove Finance

Investment accounts and manually tracked investments, with current values and this month's snapshot.

get_investments_summary

The user's current net worth, broken into checking, savings, investments, and debts, with recent history if available.

get_net_worth

Recent transactions, newest first. Covers whole calendar months: 1 means the current month to date, 3 means the current month plus the two before it.

get_recent_transactions

Detected recurring charges and subscriptions, with their typical amount and cadence. Useful for finding cuts when the user is over budget.

get_recurring_and_subscriptions

The user's saved retirement plan: assumptions, contributions, and projected outcome. Returns nothing if they have not built one.

get_retirement_plan

Spending categories where recent activity departs from the user's own baseline, with the baseline for comparison.

get_spending_anomalies

Spending broken down by category, by month, newest first. Use this rather than adding up transactions yourself.

get_spending_by_category

Compares spending between two specific months, category by category. Use this instead of calling get_spending_by_category twice and subtracting the numbers yourself.

get_spending_comparison

Mark a transaction as reviewed without changing its category.

mark_transaction_reviewed

Change the category of a single transaction. Affects only that one transaction, never other transactions from the same merchant.

recategorize_transaction

Tells Kove's development team about something the user asked for that no current Kove tool can do. Only call this after asking the user whether they would like to notify the team about it, and only after they say yes: this sends the gap to Kove for review, it does not build the capability itself.

report_missing_capability

Finds specific transactions by merchant text, amount range, or date range. Use this instead of get_recent_transactions when the user is looking for a particular past transaction rather than a recent list, e.g. "that $47 Target charge from March".

search_transactions

Update planned amounts or income in the user's monthly budget. Only the fields you pass are changed; the rest are left alone.

update_budget

Update a credit card's limit, APR, or minimum payment. Use get_debt_payoff_projection first to find which cards are missing this data and their ids.

update_credit_card

Changes the planned amount of, or removes, a custom category in the user's monthly budget.

update_custom_budget_category

Changes the planned amount of, or removes, a custom category in the user's long-term budget, either for one month or for the base plan.

update_custom_long_term_budget_category

Update an existing savings goal. Only the fields you pass are changed.

update_goal

Update planned amounts or income in the user's long-term budget, either for one month or for the base plan. Only the fields you pass are changed.

update_long_term_budget

Update the user's retirement plan, the same fields as the Retirement Planning page's form. Only the fields you pass are changed.

update_retirement_plan