MCP tool reference

Reference for every tool in the Savi MCP server: names, descriptions and input parameters.

Tool	Summary
`create_account`	Creates a new account for the authenticated user.
`create_expense_projection`	Creates an expense projection (expected future spending).
`create_goal`	Creates a new saving goal for the authenticated user.
`create_income_projection`	Creates an income projection (expected future income).
`create_invoice`	Creates a draft or sent invoice. Requires accountId from list_accounts plus line items and dates (ISO 8601). accountId (when you have a single account or one named Main Checking), status and dates are inferred when omit…
`create_life_plan`	Creates a new life plan — the top-level container for saving goals, income projections, and expense projections.
`create_rule`	Creates a transaction automation rule with optional conditions and actions. If conditions/actions are omitted, MCP infers vendor match and category actions from the name.
`create_saved_filter`	Creates a saved transaction filter with name and filterCriteria (accounts, categories, tags, date range, etc.). If filterCriteria is omitted or empty, MCP infers type and categories from the name; supplied criteria are…
`create_shared_account`	Creates a new shared account: family (accountType HOUSEHOLD) or enterprise (accountType GROUP).
`create_tag`	Creates a new tag for labeling transactions.
`create_time_log`	Creates a time-tracking entry. Requires startTime (ISO 8601), or notes with an explicit duration like '2 hours', '1h30m' or '45 minutes'. When startTime is omitted and notes contain a duration, the entry starts at 09:00…
`create_transaction`	Creates a new transaction for the authenticated user on one of their accounts.
`delete_account`	Deletes one account by accountId for the authenticated user.
`delete_file`	Deletes a file by fileId from list_files. If fileId is unknown, pass fileName: only an exact name match (case-insensitive, extension optional) is deleted; otherwise the tool returns the candidate files to ask about.
`delete_goal`	Deletes one saving goal by savingGoalId for the authenticated user.
`delete_invoice`	Deletes a draft invoice by invoiceId. Only DRAFT invoices can be deleted.
`delete_projection`	Deletes an income or expense projection by projectionId.
`delete_rule`	Deletes a transaction rule by ruleId or exact ruleName. Requires ownership (OWNER/COOWNER).
`delete_saved_filter`	Deletes a saved filter by savedFilterId or exact savedFilterName.
`delete_shared_account`	Deletes a shared account (family HOUSEHOLD or enterprise GROUP) by organizationId.
`delete_tag`	Deletes a tag by tagId. Get tagId from list_tags, or pass tagName with the exact tag name. A partial name (e.g. "business") is not deleted; this lists the similar tags so you can ask which one.
`delete_time_log`	Soft-deletes a time log by entryId.
`delete_transaction`	Deletes one transaction by transactionId for the authenticated user.
`get_current_user_info`	Returns the authenticated user's personal profile and every user identity the credential can access.
`get_financial_plan`	Returns a unified financial plan: life plans, saving goals, income/expense projections, plus chart-ready series for visualization.
`get_notification_settings`	Returns notification preferences (insight summary email cadence, etc.) from the user's profile.
`get_spending_analytics`	Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.
`list_accounts`	Lists every Savi Finance account (bank, credit card, crypto, manual, etc.) the authenticated user has access to.
`list_agent_connections`	Lists the user's active agent/connector connections. Call list_agents for available agent types.
`list_agents`	Lists available integration agents (connectors) and their capabilities. For user's active connections, call list_agent_connections.
`list_alerts`	Lists spending/category alerts (notification thresholds). For push/email prefs use get_notification_settings.
`list_categories`	Lists every transaction category visible to the authenticated user — both the global catalog (e.g. FOOD_AND_DRINK, RENT_AND_UTILITIES, INCOME) and any user-defined categories.
`list_expense_projections`	Lists expense projections (expected future spending) for the authenticated user.
`list_files`	Lists uploaded files/receipts for the authenticated user. Use file.id as fileId in update_file or delete_file.
`list_goals`	Lists every saving goal for the authenticated user across all life plans.
`list_income_projections`	Lists income projections (expected future income streams) for the authenticated user.
`list_invoices`	Lists invoices for an account. Use invoice.id as invoiceId in read_invoice, update_invoice, or delete_invoice.
`list_life_plans`	Lists life plans for the authenticated user, including embedded saving goals, income blocks, and expense blocks.
`list_rules`	Lists transaction automation rules. Use rule.id as ruleId in update_rule or delete_rule.
`list_saved_filters`	Lists saved transaction filters. Use savedFilter.id as savedFilterId in update_saved_filter or delete_saved_filter.
`list_shared_accounts`	Lists family shared accounts (HOUSEHOLD) the user belongs to.
`list_spendables`	Lists monthly spendable (guilt-free spend) limits for the authenticated user. To change limits use update_spendable; for threshold alerts use list_alerts; for email preferences use get_notification_settings.
`list_tags`	Lists tags belonging to the authenticated user.
`list_time_logs`	Lists time-tracking entries. Use entry.id as entryId in update_time_log or delete_time_log. Pass periodHint or filter.search like "this week" to infer a start-time range.
`list_transactions`	Lists transactions for the authenticated user with optional filters. Call this to: • Verify a transaction was created (call after create_transaction). • Show recent transaction history to the user. • Search for a specif…
`list_trip_mileage_logs`	Lists trip/mileage deduction transactions (tagged mileage-deduction or name contains 'mileage').
`read_account`	Reads one account by accountId for the authenticated user.
`read_goal`	Reads one saving goal by savingGoalId for the authenticated user.
`read_invoice`	Reads one invoice by invoiceId from list_invoices or create_invoice.
`read_life_plan`	Reads one life plan by lifePlanId, including saving goals and fixed income/expense blocks.
`read_shared_account`	Reads one shared account (family HOUSEHOLD or enterprise GROUP) by organizationId.
`read_transaction`	Reads one transaction by transactionId for the authenticated user.
`update_account`	Updates one account by accountId for the authenticated user. Wraps the updateAccount RPC.
`update_file`	Updates file metadata (name, date) by fileId. Wraps the updateFile RPC.
`update_goal`	Updates one saving goal by savingGoalId for the authenticated user. Wraps the updateSavingGoal RPC.
`update_invoice`	Updates an invoice by invoiceId. Wraps the updateInvoice RPC.
`update_notification_settings`	Updates insight-summary email notification settings (enabled flag and optional cron schedule). Wraps the updateInsightSummaryNotificationSetting RPC.
`update_projection`	Updates an income or expense projection by projectionId. Wraps the updateProjection RPC.
`update_rule`	Updates a transaction automation rule by ruleId.
`update_saved_filter`	Updates a saved filter by savedFilterId. Wraps the updateSavedFilter RPC.
`update_shared_account`	Updates a shared account (family or enterprise) by organizationId. Wraps the updateOrganization RPC.
`update_spendable`	Sets the monthly spendable (guilt-free spend) limit. Wraps the updatePersonalPreference RPC.
`update_tag`	Updates a tag by tagId. Wraps the updateTag RPC.
`update_time_log`	Updates a time log by entryId. Wraps the updateTimeLog RPC.
`update_transaction`	Updates one transaction by transactionId. Wraps the updateTransaction RPC.