FAQ
Can the agent see other users' data?
No. A token is bound to one user, and that's checked on the server for every call. Reaching for someone else's uid returns the exact same not_found error as a request for a record that doesn't exist.
Do I need Premium?
Yes. MCP is available only on Fealthy's Premium plan. On a Free plan, a call returns an error with reason plan_restricted; demo accounts are never supported, regardless of any other setting.
How many tokens can I have?
Up to 5 active at once, each with its own name, unique among your active tokens. A token is issued for a lifetime of 1 hour to 365 days.
Where do I get a token?
There's no dedicated screen in the app yet — the Fealthy team issues one on request.
What do I do if a token leaks?
Ask the Fealthy team to revoke it right away — that takes effect within 60 seconds at the latest. The damage is limited to that token's own level (Write or Read) and your own data: the token doesn't work anywhere except /v1/mcp, and it never gives access to anyone else's records.
Why does the agent answer in Ukrainian or in English?
The response language is your Fealthy profile's interface language. The server directly instructs the agent to answer in that language, regardless of the language the instructions themselves are written in.
Can I connect something other than Claude?
Yes. Any MCP client that supports the Streamable HTTP transport and lets you set an Authorization header will work. Connection examples are on the Connect page.
Is there a production version?
Not yet. The server today is available only in Fealthy's dev environment.
Why does the list show 70 tools?
70 is the full list for a Write-level token; a Read-level token shows 29 (only list_*/get_*). The count doesn't depend on which client you connect with.
Does a batch call count as one operation?
It depends on the tool. A call like create_transaction with several rows at once costs as many operations as it has rows. But create_transfer and create_exchange each count as one operation, even though each one creates two transactions.
What happens if I exceed the rate limit?
The next call returns a rate_limited error with a retryAfterSeconds field — exactly how long to wait before retrying. The limit is shared across all of your tokens: 50 operations per 60 seconds.
Can the agent change system (built-in) categories?
It can't delete or change a shared record — that's global_read_only. But renaming or changing the icon of a system category, or hiding it, is possible: that creates a change just for you, not for other users and not for the shared record itself.
Why is a date off by a day?
Most likely, it's the timezone. A date or time with no explicit offset is interpreted in your timezone: first your Fealthy profile setting, then the app-timezone request header, and if neither is set, Europe/Kyiv. If your profile has no timezone set, send an app-timezone header from your client — more detail on the Connect page.