Ten sam rejestr narzędzi (łącznie 63) obsługuje serwer MCP i asystenta w aplikacji. Każde narzędzie dostaje Państwa identyfikator użytkownika i identyfikator profilu ze zweryfikowanego tokenu, więc klient nie może podstawić innego użytkownika ani innego profilu. Wyniki składane są pole po polu, narzędzie nigdy więc nie zwraca surowego rekordu z bazy.
Opisy narzędzi i komunikaty błędów są po angielsku, dzięki czemu model zachowuje się tak samo niezależnie od tego, w jakim języku Państwo z nim rozmawiają. To, co Państwu odpowie, formułuje w Państwa języku.
Narzędzia odczytujące (35)
Dostępne z uprawnieniem Odczyt w każdym planie.
Rachunki i wartość netto majątku
| Narzędzie | Co zwraca |
|---|
get_accounts | Rachunki (nazwa, bank, saldo, waluta, typ, ostatnia synchronizacja) oraz sumę w Państwa walucie wyświetlania. Rachunki ukryte tylko na żądanie. Bez numerów rachunków i IBAN. Do tego oprocentowanie kont oszczędnościowych i wiek danych (staleDays większe niż 0 = przypomnienie „brak nowych danych”). |
get_net_worth | Wartość netto majątku, aktywa i zobowiązania łącznie, rozbicie na kategorie, z tego samego wyliczenia co strona Wartość netto. |
Transakcje
| Narzędzie | Co zwraca |
|---|
get_transactions | Transakcje filtrowane według kategorii, typu, okresu i sprzedawcy; najwyżej 100 wierszy. |
get_spending_summary | Wydatki według kategorii za okres z porównaniem do okresu poprzedniego. Przelewy i zakupy inwestycyjne wyłączone. |
analyze_spending_patterns | Wydatki według dni tygodnia, najczęstsi sprzedawcy, trend miesięczny, nietypowe transakcje i wskazówki oszczędnościowe za ostatnie miesiące. |
get_transfer_candidates | Prawdopodobne odpowiedniki jednej transakcji dla przelewu między Państwa kontami (przeciwny kierunek, ta sama kwota, do 10 dni) i czy jest już sparowana. |
get_categorization_rules | Państwa własne reguły kategoryzacji (warunki, kategoria docelowa, priorytet, włączone/wyłączone, liczba dopasowań) i limit planu — ile reguł Państwo mają i ile wolno (dla całego konta). Opcjonalnie także reguły wbudowane. |
Budżety i cele
| Narzędzie | Co zwraca |
|---|
get_budgets | Budżety z wykorzystaniem w bieżącym miesiącu, kwotą pozostałą i stanem. |
get_goals | Cele oszczędnościowe z postępem. |
Inwestycje
| Narzędzie | Co zwraca |
|---|
get_investments | Akcje i ETF według rachunków maklerskich, pozycje kryptowalutowe, wartości i zysk w Państwa walucie wyświetlania. |
get_tax_summary | Widok testu okresu posiadania przy akcjach i kryptowalutach dla Państwa rynku oraz dywidendy za rok. To samo wyliczenie co przegląd podatkowy. |
get_alt_investments | P2P, crowdfunding, obligacje, surowce i podobne pozycje, zgrupowane według platformy i typu. |
get_alt_investment_performance | Wpłaty, wypłaty, odsetki, opłaty, niewypłacalności i przebieg wyceny. |
Subskrypcje i przepływy
| Narzędzie | Co zwraca |
|---|
get_subscriptions | Subskrypcje z kwotą, cyklem, datą kolejnej płatności oraz sumą miesięczną i roczną. |
predict_cashflow | Prognozę na kolejne miesiące z historycznych średnich i płatności powtarzalnych. |
Nieruchomości, pojazdy, kosztowności
| Narzędzie | Co zwraca |
|---|
get_properties | Nieruchomości z posiadaną wartością, ceną zakupu, wzrostem wartości i powiązanym kredytem. |
get_property_cashflow | Przychody i wydatki z najmu według nieruchomości i kategorii, przepływ netto i rentowność. |
get_property_utility_settings | Ustawione media i bieżące ceny jednostkowe dla jednej nieruchomości. |
get_vehicles | Pojazdy z wartością, oznaczeniem leasingu i miesięcznymi kosztami eksploatacji. |
get_vehicle_costs | Koszty według kategorii i pojazdu. |
get_valuables | Kosztowności z ceną zakupu i wartością bieżącą (albo szacowaną) oraz amortyzacją. |
Pożyczki i długi
| Narzędzie | Co zwraca |
|---|
get_mortgages | Kredyty hipoteczne i pożyczki z saldem na dziś, oprocentowaniem, ratą i liczbą pozostałych miesięcy. |
get_debt_overview | Wszystkie długi łącznie z debetem i zadłużeniem na kartach kredytowych, ważone oprocentowanie oraz kolejność według metody lawiny i kuli śnieżnej. |
get_mortgage_payments | Historię rat z rozbiciem na kapitał i odsetki. |
Oszczędności i plany
| Narzędzie | Co zwraca |
|---|
get_savings_envelopes | Koperty z ID, rachunkiem, saldem, celem i postępem (także koperty bez celu), opcjonalnie z ostatnimi ruchami, oraz suma wszystkich kopert w Państwa walucie wyświetlania. |
get_savings_rate_comparison | Oprocentowanie Państwa kont oszczędnościowych na tle rynku: rozpiętość, mediana i najwyższa stawka śledzonych ofert oraz oficjalna średnia rynkowa. To samo porównanie co strona konta oszczędnościowego. |
get_financial_plans | Szablony zapisane w kalkulatorach — kredyt, FIRE, inflacja, strategia inwestycyjna, porównanie pojazdów, wakacje i spłata długów: rodzaj, id, nazwa i jednowierszowy opis danych wejściowych. |
get_saved_plan | Jeden zapisany szablon ze wszystkimi danymi. Przy kredycie dodatkowo wyliczony wynik — rata, suma spłat, odsetki, LTV i DTI — z tego samego silnika co strona kalkulatora, więc liczby zgadzają się z tym, co Państwo widzą. |
get_fire_progress | Postęp w kierunku niezależności finansowej z rachunków, inwestycji i wydatków. |
Gospodarstwo domowe
| Narzędzie | Co zwraca |
|---|
get_utility_usage | Odczyty i koszty mediów według nieruchomości i okresu. |
get_appliances | Urządzenia ze zużyciem i pomiarami. |
get_household_summary | Koszty gospodarstwa domowego w ujęciu wszystkich nieruchomości: media, wydatki, przychody i raty kredytów. |
Pozostałe
| Narzędzie | Co zwraca |
|---|
get_financial_score | Wskaźnik zdrowia finansowego (0 do 850) z siedmioma komponentami, to samo co Analityka → Wskaźnik. |
explain_term | Definicję ze słownika z przykładem i źródłem. Nie czyta żadnych danych użytkownika. |
get_plan_and_limits | Państwa plan (także okres próbny), jego funkcje, wszystkie limity z bieżącym wykorzystaniem (dla całego konta), czego nie można już dodać i czy konektor może zapisywać. |
Narzędzia podglądu (14)
Widzi je każdy konektor z uprawnieniem Zapis, w każdym planie; uruchomić można je jednak tylko w planie Premium albo Max (liczy się także okres próbny). W planie Free serwer je odrzuca z TIER_FEATURE, a bez uprawnienia Zapis z SCOPE_REQUIRED, nawet jeśli klient wciąż je proponuje z wcześniejszego połączenia. Wyliczają, co zrobiłby zapis, zwracają tekst do potwierdzenia oraz confirmation_token. Nie zapisują niczego.
prepare_transaction, prepare_stock_trade, prepare_crypto_trade, prepare_utility_reading, prepare_bank_import, prepare_budget_update, prepare_valuable_add, prepare_valuable_update, prepare_categorization_rule, prepare_categorization_rule_update, prepare_rule_application, prepare_transfer_pair, prepare_envelope_transfer, prepare_balance_confirmation
Tokeny potwierdzające
Każde narzędzie zapisujące wymaga confirmation_token ze swojego podglądu. Token podpisuje serwer i jest powiązany z Państwem, profilem, rodziną narzędzia i dokładnymi argumentami podglądu; jest ważny 10 minut i nigdzie nie jest zapisywany. Zapis bez tokenu, z tokenem wygasłym albo z argumentami innymi niż w podglądzie zostaje odrzucony z komunikatem, aby model powtórzył podgląd. Gwarantuje to, że zapisze się to, co było w podglądzie; to, czy poproszono Państwa o zatwierdzenie podglądu, pozostaje po stronie Państwa klienta AI.
Narzędzia zapisujące (14)
Wymagają uprawnienia Zapis, planu Premium albo Max oraz ważnego confirmation_token. Bez uprawnienia serwer odpowie SCOPE_REQUIRED, bez planu TIER_FEATURE i nic się nie wykona. Każde uruchomione wywołanie, udane i nieudane, trafia do dziennika audytu. Rekord, który zapis tworzy lub zmienia (transakcja, także z importu, transakcja giełdowa, odczyt, kosztowność, budżet, reguła), niesie ponadto swoje pochodzenie; zmiany zbiorcze (zastosowanie reguły, sparowanie przelewu, przesunięcie między kopertami, potwierdzenie salda) zostają tylko w dzienniku audytu.
| Narzędzie | Co zapisuje |
|---|
add_transaction | Transakcję na jednym z Państwa rachunków; koryguje saldo. |
add_stock_trade | Kupno albo sprzedaż na rachunku maklerskim; przelicza pozycje. |
add_crypto_trade | Kupno albo sprzedaż na rachunku kryptowalutowym; przelicza pozycje. |
add_utility_reading | Odczyt mediów albo wywóz odpadów, wyceniony według ustawień nieruchomości. |
add_valuable | Nową kosztowność. |
update_budget | Kwotę, nazwę albo okres istniejącego budżetu. |
update_valuable | Nazwę, stan, wartość bieżącą albo notatki istniejącej kosztowności. |
import_bank_transactions | Tekst wyciągu wklejony do czatu (CSV, camt.053, OFX, MT940, GPC, QIF i pozostałe formaty tekstowe ze strony Formaty wyciągów) tym samym parserem i importem co strona internetowa, łącznie z wykrywaniem duplikatów i przelewów. Nie do rachunku synchronizowanego z Wallet by BudgetBakers. |
create_categorization_rule | Własną regułę kategoryzacji dla nowych transakcji. Obowiązuje limit planu dla całego konta (Free 5, Premium 50, Max bez limitu). Podgląd pokazuje, ile istniejących transakcji reguła by objęła. |
update_categorization_rule | Nazwę, warunki, kategorię docelową, metodę płatności, wykluczenie ze statystyk, priorytet albo włączenie/wyłączenie własnej reguły. Reguł wbudowanych nie można edytować. |
apply_categorization_rule | Stosuje regułę do istniejących transakcji i zmienia ich kategorię. Transakcje skategoryzowane ręcznie zmienia tylko na wyraźne życzenie. |
create_transfer_pair | Paruje dwie transakcje jako przelew między Państwa kontami; obie dostają kategorię przelew i przestają się liczyć do przychodów i wydatków. |
transfer_envelope_funds | Przesunięcie pieniędzy między kopertami oszczędnościowymi jednego rachunku albo z/do wolnych środków; zapisuje się w historii obu kopert, saldo rachunku się nie zmienia. |
confirm_account_balance | „Saldo się zgadza” — potwierdza bieżące saldo rachunku bez nowych danych i wyłącza przypomnienie; opcjonalnie dłuższy próg dla rzadko używanego rachunku. Saldo się nie zmienia. |
Wszystkie narzędzia zapisujące szukają celu (rachunku, brokera, nieruchomości, budżetu, kosztowności) według identyfikatora albo nazwy wyłącznie w Państwa profilu. Gdy nazwa nie pasuje, zwracana jest lista Państwa własnych pozycji i nic nie zostaje zapisane.