FealthyMCP
English

Connect your AI agent to Fealthy

Ask in plain words. Your agent reads your data and, if you allow it, changes it.

For ChatGPT, Claude, Gemini and other clients that support MCP: as a connector, or with a token.

How it works

You ask, your agent calls the tools

Your agent reads your data in Fealthy through MCP, an open protocol. It does not need the chat in the app.

  1. Read only

    Your AI agent

    You ask in plain words

    How much did I spend this week?

    The agent picks the tool itself

    list_transactions · current week

    Fealthy returns the transaction list

    The agent does the sum

    The agent adds it up itself.

  2. Read and write

    Your AI agent

    You ask for a change the same way

    Create an Entertainment budget of ₴3000 a month.

    First the agent finds the category

    list_categories

    Then it creates the budget

    create_budget · ₴3000 · current month

    Changes need Read and write access

    Token level: Read and write.

  1. You ask in plain words

    You type in your own client, like any chat.

  2. The agent picks the tool itself

    You don’t need to know any tool names.

  3. Fealthy returns the transaction list

    Your data only, for this week.

  4. The agent does the sum

    The server doesn’t total anything.

  5. You ask for a change the same way

    One sentence is enough here too.

  6. First the agent finds the category

    It looks in your own category list.

  7. Then it creates the budget

    A ₴3000 limit for the current month.

  8. Changes need Read and write access

    The server refuses a Read only token.

Your AI agent

How much did I spend this week?

list_transactions · current week

The agent adds it up itself.

Create an Entertainment budget of ₴3000 a month.

list_categories

create_budget · ₴3000 · current month

Token level: Read and write.

Prompts and tool names are from the mcp.fealthy.ua docs. Amounts in examples are illustrative, and the answer comes from your agent.

Examples

What you can ask for

These prompts come from the docs. The agent picks the tools itself.

Read only

The agent can see your data but can’t change anything.

  • list_*
  • get_*
  • Show my accounts and their current balances.
  • Which category is eating up the most money this month?
  • How much is left in my Coffee budget this month?
  • Show me every debt I still owe.

Read and write

The agent can also add, change and delete records.

  • create_*
  • update_*
  • delete_*
  • Add a ₴350 expense in Groceries today, paid from my PrivatBank card.
  • Update my Transport budget limit to ₴1500.
  • Create a rule: anything described as ‘Silpo’ goes in Groceries.
  • Mark this transaction as a transfer to my Savings account.

Control

What stays in your hands

With a token, you decide its access level, its expiry and when to revoke it.

  • Your data only

    The server checks this on every call.

  • You choose the level

    With a Read only token the server refuses any write.

  • up to 5

    active tokens

    Each lasts up to 365 days.

  • 60 s

    revocation delay

    A revoked token stops working within this time.

  • 50

    operations per 60 seconds

    Shared across all your tokens and connectors.

  • The log

    Fealthy logs that a call happened. That record holds no arguments and no answer.

Data goes straight to your client. What it does with the data afterwards is outside Fealthy’s control. About security(opens in a new tab)

Limits

What the server doesn’t do

Some things stay with the app and with you.

Doesn’t connect your bank

Bank sync and statement import are set up in the app only.

Doesn’t make payments

A transfer or exchange is only recorded.

Doesn’t change your plan or language

Your base currency also stays as set in the app.

The server doesn’t ask you to confirm a delete

The agent may ask first, but the server won’t stop a delete.

Setup

Four steps

You need a client that supports MCP.

Step 2Connect with a connector or a token

As a connector: add the server address in ChatGPT, Claude, Gemini or another client that supports connectors, sign in to Fealthy in the browser and approve. No token to copy. Plan, region and language requirements in the client itself are set by its vendor.

Step 3Or a token from the app

For clients without OAuth: Settings → Integrations → AI agents (MCP), pick an access level and an expiry. The token is shown once. For Claude Code it’s one command: swap fpat_your_token for your own token.

claude mcp add -s user -t http fealthy https://main.api.fealthy.ua/v1/mcp -H "Authorization: Bearer fpat_your_token" -H "app-timezone: Europe/Kyiv"

Other clients have step-by-step instructions.

Step 4A new chat, a first question

Open a new chat with Fealthy connected and ask: “Show my accounts and their current balances.” Claude Code can’t see a server added mid-session: start a new one.

The examples page on mcp.fealthy.ua: three prompts about accounts, this week’s spending and categories, with a note on the list_transactions call under the second.

Ask your agent about your money

Step-by-step instructions are on mcp.fealthy.ua.

A connector needs no token: you just sign in to Fealthy. If your client asks for a token, you create it in the app.