FYN

Read recurring food purchases, observed buying cadence and cheapest comparable stores in the household’s own receipts. Does not infer pantry contents, nutrition or allergy safety.

get_grocery_staples

Lists investment holdings. Each row includes symbol, quantity, current_value, cost_basis, and gain_loss, plus total_holdings. An empty or unavailable store returns an empty holdings list.

get_holdings

Read item price changes and cheapest comparable stores from this household’s own receipt history. Returns observed prices, dates and comparison limits; never live store quotes.

get_price_history

Returns net worth for linked accounts: assets minus liabilities (net_worth), plus total_assets, total_liabilities, cash, invested, asset_count, and liability_count.

get_net_worth

Returns linked investment portfolios: portfolio_count, total_value, and each portfolio name, type, exchange, and value. Currency is USD. An empty or unavailable portfolio store returns portfolio_count 0.

get_portfolio_summary

Lists up to 10 products this household bought whose later receipt at the same store shows a lower price while the purchase receipt's return window is still open. Each row includes product, merchant, you_paid, now_priced_at, reclaimable, return_by, and days_left. Prices come only from this household's receipts. return_by is that return window, not confirmation that the store offers a price adjustment.

get_price_adjustments

Totals spending from scanned receipts. Optional filters: location (matched against the printed store address; every word must appear), merchant, start_date, and end_date (YYYY-MM-DD). Re-scans of the same meal are collapsed and counted in duplicate_scans_removed. Returns total, receipt_count, by_merchant, and the kept receipts. The total covers scanned receipts only and omits purchases that were not scanned.

get_receipt_spending

Returns transactions newest first. Optional filters: merchant, category, start_date, end_date (YYYY-MM-DD). limit defaults to 10. Each row includes date, merchant, amount, and category, plus receipt line items when a scanned receipt is linked.

get_recent_transactions

Returns the savings rate for a period: (income minus expenses) divided by income, as a percent, plus amount_saved, total_income, and total_expenses. The rate is 0 when income is 0. period is this_month (default), last_month, this_year, or last_year.

get_savings_rate

Reads itemized receipt line items. query matches a product or brand across receipts. merchant with optional start_date and end_date, and with query empty, returns every line item on the matching receipts. A single day uses the same YYYY-MM-DD value for start_date and end_date. At least one of query or merchant is required; otherwise the result is empty.

search_receipt_items

Semantic search over this household's receipts and transactions. Returns up to 10 relevance-ranked receipts with itemized line items (and a presigned photo URL when the receipt is an image or PDF) and up to 15 matching transactions (merchant, date, amount, category). result_set.ordering is "relevance", result_set.complete is false, and result_set.truncated is true when more matches existed than were returned. The list is not the full ledger and is not ordered by amount or date.

search_finances

Returns spending grouped by merchant or category, with posted purchase counts and average ticket. A posted charge is the visit proxy; refunds reduce net spending and are not purchases. group_by is required. The optional category filter accepts a raw category key or a display label. limit defaults to 5. Omitted dates cover all time. total_spending covers every matching group; breakdown lists the top groups.

get_spending_breakdown

Splits one scanned receipt across people. Inputs are receipt_id, assignments (each person's name and the 0-based indexes of the line items they ordered), and optional shared_item_indexes (items divided evenly across everyone). Returns each person's share with tax and tip allocated in proportion to their items, the line items with indexes, and pre-filled Venmo request links (venmo and venmo_web). payment_links.cashapp is null. Does not send the requests or move money.

split_bill

Returns monthly and yearly totals for recurring charges. monthly_total and subscription_count cover services and memberships (streaming, software, gyms). bills_monthly_total and bill_count cover rent, utilities, childcare, loans, insurance, and other bills. recurring_monthly_total is both. Transfers and card payments are excluded. Charges with an irregular or unknown frequency are listed in not_in_totals and are not included in the monthly or yearly totals.

get_subscription_total

Lists active recurring outflows. Each row includes name, amount, frequency, next and last charge, category, and kind (subscription, bill, or transfer), plus status and currency.

get_subscriptions

Sums ledger transactions that match the filters. direction selects the total: expense (default), income, net, credit, or transfer. merchant matches a store name; category matches a spending category or product type. A category total also includes that product bought as line items on scanned receipts at other stores, returned as items_elsewhere and total_with_items. Omitted dates cover the available ledger. Expense totals exclude transfers and income.

get_transaction_sum

Summarize observed trips using posted transaction and receipt locations, costs per day and dining tickets compared with home. Missing location evidence is reported; these are past costs, not travel quotes.

get_trip_summary