Skip to main content

MCP tools reference

All 46 tools the Assetli MCP server exposes, what each returns, and how a write is confirmed.

Last updated: September 16, 2026

The same tool registry serves the MCP server and the in-app assistant. Every tool receives your user id and the connector’s profile id from the verified token; the client cannot pass a different user or profile. Results are mapped field by field, so a tool never returns a raw database record.

Tool descriptions and error messages are in English, so the model behaves the same whatever language you speak to it in. What it says back to you it phrases in your language.

Read tools (30)

Available with the Read scope on every plan.

Accounts and net worth

ToolReturns
get_accountsAccounts (name, bank, balance, currency, type, last sync) and the total in your display currency. Hidden accounts only on request. No account numbers or IBANs.
get_net_worthNet worth, total assets and liabilities, breakdown by category, from the same calculation as the Net worth page.

Transactions

ToolReturns
get_transactionsTransactions filtered by category, type, date range and merchant; up to 100 rows.
get_spending_summarySpending by category for a period with comparison to the previous period. Transfers and investment purchases excluded.
analyze_spending_patternsSpending by weekday, top merchants, monthly trend, unusual transactions and savings tips over the last months.

Budgets and goals

ToolReturns
get_budgetsBudgets with current-month spending, remaining amount and status.
get_goalsSavings goals with progress.

Investments

ToolReturns
get_investmentsStocks and ETFs per broker account, crypto holdings, values and gains in your display currency.
get_tax_summaryHolding-period test view for stocks and crypto for your market, plus dividends for a year. Same engine as the tax page.
get_alt_investmentsP2P, crowdfunding, bonds, commodities and similar positions, grouped by platform and type.
get_alt_investment_performanceDeposits, withdrawals, interest, fees, defaults and valuation trend.

Subscriptions and cash flow

ToolReturns
get_subscriptionsSubscriptions with amount, cycle, next payment, monthly and yearly totals.
predict_cashflowForecast for the coming months from historical averages and recurring payments.

Property, vehicles, valuables

ToolReturns
get_propertiesProperties with owned value, purchase price, appreciation and the linked mortgage.
get_property_cashflowRental income and expenses per property and category, net cash flow and yield.
get_property_utility_settingsConfigured utilities and current unit prices for one property.
get_vehiclesVehicles with value, leasing flag and monthly run-rate costs.
get_vehicle_costsCosts by category and vehicle.
get_valuablesValuables with purchase and current (or estimated) value and depreciation.

Loans and debts

ToolReturns
get_mortgagesMortgages and loans with balance to today, rate, payment and remaining months.
get_debt_overviewAll debts including overdrafts, weighted rate, and avalanche and snowball ordering.
get_mortgage_paymentsPayment history with principal and interest split.

Savings and plans

ToolReturns
get_savings_envelopesEnvelopes with balance and optional history.
get_financial_plansSaved FIRE, debt payoff, mortgage, inflation and strategy calculations.
get_fire_progressProgress towards financial independence from accounts, investments and spending.

Household

ToolReturns
get_utility_usageUtility readings and costs per property and period.
get_appliancesAppliances with consumption and measurements.
get_household_summaryHousehold costs across properties: utilities, expenses, income and mortgage payments.

Other

ToolReturns
get_financial_scoreFinancial health score (0 to 850) with seven components, same as Analytics → Score.
explain_termA glossary definition with example and source. Reads no user data.

Preview tools (8)

Listed only to connectors with the Write scope on Premium or Max. They compute what a write would do, return a confirmation message and a confirmation_token. They write nothing.

prepare_transaction, prepare_stock_trade, prepare_crypto_trade, prepare_utility_reading, prepare_bank_import, prepare_budget_update, prepare_valuable_add, prepare_valuable_update

Confirmation tokens

Every write tool requires the confirmation_token from its preview. The token is signed by the server and bound to your user, the profile, the tool family and the exact arguments of the preview; it is valid for 10 minutes and is never stored. A write without a token, with an expired token, or with arguments that differ from the preview is refused with a message telling the model to run the preview again. This guarantees that what gets written is what was previewed; whether you were asked to approve the preview is still up to your AI client.

Write tools (8)

Require the Write scope, a Premium or Max plan and a valid confirmation_token. Each call is recorded in the audit log and the written record is tagged with its origin.

ToolWrites
add_transactionA transaction on one of your accounts; adjusts the balance.
add_stock_tradeA buy or sell on a broker account; recalculates holdings.
add_crypto_tradeA buy or sell on a crypto account; recalculates holdings.
add_utility_readingA utility reading or waste pickup priced from the property’s settings.
add_valuableA new valuable.
update_budgetAmount, name or period of an existing budget.
update_valuableName, condition, current value or notes of an existing valuable.
import_bank_transactionsA pasted Air Bank, Raiffeisenbank or UniCredit CSV through the same import routine as the web, with duplicate detection.

All write tools resolve the target (account, broker, property, budget, valuable) by id or by name within your profile only. A name that does not match returns the list of your own items instead of writing anything.