AI connection (MCP)

Assetli runs a remote MCP server. Once connected, your AI client can read your financial data and, if you allow it, add or edit records, in the same way the web app does.

Connector URL: https://assetli.app/api/mcp

What you can do

The connector offers 63 tools: 35 for reading, 14 previews and 14 writes. The full list is in MCP tools.

Reading (every plan, Read scope):

• Net worth, account balances and how old their data is, spending by category, budgets, goals and savings envelopes.
• Portfolio, holding-period test view, alternative investments, properties, vehicles, valuables, loans and debts, household energy, subscriptions and the cash flow forecast.
• The financial score, your saved calculator plans, your categorization rules, likely transfer counterparts, how your savings rate compares with the market, and your plan with its limits.
• Terms explained from the Assetli glossary.

Writing (Read and write scope, Premium or Max plan):

• Add transactions, stock and crypto trades, utility readings and valuables; update budgets and valuables.
• Import a bank statement pasted into the chat as text.
• Create and edit categorization rules and apply a rule to existing transactions.
• Pair two transactions as a transfer between your own accounts.
• Move money between savings envelopes.
• Confirm that an account balance is still right (“Balance is correct”).

There are no delete tools. Every write has a preview tool, and the server refuses a write that does not carry the preview’s token for the same values.

How access is granted

1. Your AI client registers itself with Assetli automatically (OAuth 2.1 dynamic client registration).
2. You are sent to Assetli to sign in if needed.
3. On the consent screen you pick one profile and grant Read, and optionally Write too (the Read and write scope). Write includes read. On Free, the Write option carries a note with a link to pricing: writing through AI is part of Premium and starts working as soon as you switch, without reconnecting.
4. Assetli issues an access token valid for 1 hour and a refresh token valid for 60 days. The client refreshes silently; the refresh token is rotated on every use.

The token is tied to your user, the chosen profile, the granted scope and the connector that requested it. Your password is never shared with the AI client.

Reading is free on every plan. Writing and importing require Premium or Max; the 30-day trial counts. Which tools the client sees depends on the scope: with Read and write it sees the preview and write tools on every plan, but on Free the server refuses them. The AI learns this when it connects and offers you a link where you can make the change yourself in the web app, plus a direct link to switch to Premium.

When your plan changes

Upgrade: a connection with the Read and write scope starts writing right away; there is nothing to reconnect. Downgrade or end of the trial: the write tools stay visible in the client, but every call is refused with “Writing and importing over MCP are part of the Premium plan” and nothing is written. A connector with only the Read scope does not see the write tools on any plan; to write, remove it and connect again choosing Read and write. Exception: a connector added on Free before 30 October 2026 remembers a list without the write tools, so after an upgrade remove it and connect again once (in ChatGPT, refreshing the app in its settings is enough).

Setup guides

• Claude: claude.ai, Claude Desktop and Claude Code. Anthropic allows custom connectors on every Claude plan, one on Claude Free.
• ChatGPT: apps in Developer mode. OpenAI allows writing only on Business, Enterprise and Edu workspaces.
• Gemini: custom apps in the Gemini web app (personal Google account, 18+, United States, English), Gemini CLI and Gemini Enterprise.

What each AI client allows is decided by its maker and changes often; each guide says when it was last checked and links to the maker’s own documentation.

Revoking access

Open the account menu (top right) → AI Connection (MCP) in the web app. Every active connector is listed with its scope. “Revoke” revokes all its tokens immediately; the client has to go through consent again to reconnect.

What Assetli sees

Your conversation stays in the AI client. Assetli receives only the tool calls: the tool name and its arguments. Reads are not logged. Writes are recorded in an audit log for 12 months; those in the currently selected profile are shown on the same page where you manage connectors. The full picture, including what the server enforces and what it does not, is in Security and data flow.