get_user_info reads your profile, plan, feature flags and quotas; set_user_preferences updates the profile fields that shape tax guidance. Full parameters are on the tools reference.
Responses reflect your live AI2Fin account. A plan-gated call never throws — it returns
tool_failed with requiredPlans and an upgradeUrl, so the assistant can explain rather than fail silently.get_user_info
set_user_preferences
Any subset of countryCode (ISO code), businessType (INDIVIDUAL, SOLE_TRADER, COMPANY, …), industry, profession, aiContextInput (a note the assistant should keep in mind) and hasStudyLoan (true to include compulsory study-loan repayments in the tax forecast, null to clear). Returns { userId, updated: [...] } naming the fields that changed. It is a write, so clients other than Meta Muse (which asks the user itself) confirm it with a confirmToken first; Muse is not offered this tool at all.
Which plan unlocks which tools
Plan gates come from the tool registry (thePlan column of the published catalogue at https://api.ai2fin.com/.well-known/mcp-server/tools.json). Feature flags are checked per call; some tools gate only certain views or actions.
Typical flow
- The assistant calls
get_user_infowithview: "feature_access"andfeature: "ai_categorization". - It sees
hasAccess: falseandupgradeRequired: true. - It tells you which plan unlocks the feature and points at
upgradeUrlinstead of attempting the gated call.
Next steps
Transaction tools
Query, analyse and edit transactions
Bill tools
Recurring bills and payments
