{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "pl.aiagenthub.ksiegowosc/centrum-finansowe",
  "version": "1.1.2",
  "title": "Centrum Finansowe AI Agent HUB",
  "description": "Faktury, KSeF, koszty i płatności firm z konta — odczyt i zmiany, wiele firm na koncie.",
  "websiteUrl": "https://ksiegowosc.aiagenthub.pl/dla-agentow",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://ksiegowosc.aiagenthub.pl/mcp",
      "supportedProtocolVersions": [
        "2025-11-25",
        "2025-06-18",
        "2025-03-26",
        "2024-11-05"
      ]
    }
  ],
  "protocolVersion": "2025-11-25",
  "serverInfo": {
    "name": "pl.aiagenthub.ksiegowosc/centrum-finansowe",
    "title": "Centrum Finansowe AI Agent HUB",
    "version": "1.1.2"
  },
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://ksiegowosc.aiagenthub.pl/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {},
    "prompts": {}
  },
  "authentication": {
    "required": true,
    "schemes": [
      "oauth2",
      "bearer"
    ],
    "protected_resource_metadata": "https://ksiegowosc.aiagenthub.pl/.well-known/oauth-protected-resource/mcp",
    "authorization_servers": [
      "https://ekuxswlfswacpfetyfsh.supabase.co/auth/v1",
      "https://ksiegowosc.aiagenthub.pl"
    ],
    "api_keys": "Klucze API (Bearer cfa_…) użytkownik tworzy w panelu: https://ksiegowosc.aiagenthub.pl/dashboard/agents"
  },
  "documentation": "https://ksiegowosc.aiagenthub.pl/dla-agentow",
  "tools": [
    {
      "name": "list_companies",
      "title": "Lista firm na koncie",
      "description": "Firmy, którymi zarządza połączone konto (jedno konto może prowadzić wiele firm, np. biuro rachunkowe). Zwraca id, nazwę, NIP, profil podatkowy i stan integracji (Systim, KSeF). Wywołaj najpierw — każde narzędzie działające na danych firmy przyjmuje company_id. Gdy użytkownik mówi o firmie nazwą albo NIP-em, dopasuj ją tutaj; przy niejasności zapytaj, której firmy dotyczy polecenie.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_company",
      "title": "Ustawienia firmy",
      "description": "Pełna konfiguracja jednej firmy: dane, profil podatkowy (VAT, forma opodatkowania, okres VAT), domyślne płatności, szablony Systim, tryb wysyłki do KSeF, status w Białej Liście VAT i stan integracji. warnings to rzeczy w konfiguracji, które psują księgowanie (np. pełna księgowość bez schematów księgowania) — pokaż je użytkownikowi. Formę księgowości w samym Systim sprawdza systim_accounting_setup. Bez haseł i tokenów — tych serwer nigdy nie zwraca.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "update_company",
      "title": "Zmień ustawienia firmy",
      "description": "Zmienia dane i konfigurację firmy. Podaj tylko pola do zmiany. Profil podatkowy (vat_payer, vat_exemption_type, vat_exemption_legal_basis, tax_form, ryczalt_rate, vat_period) decyduje o tym, jak księgowane są faktury — zmieniaj go tylko na wyraźne polecenie użytkownika i ustaw confirm_tax_profile: true, gdy użytkownik potwierdził poprawność profilu.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "create_company",
      "title": "Dodaj firmę",
      "description": "Dodaje nową firmę do konta. Najpierw sprawdź NIP narzędziem lookup_company_by_nip, żeby wpisać pełną nazwę z rejestru. Po dodaniu firma potrzebuje integracji (connect_systim, connect_ksef) i potwierdzenia profilu podatkowego (update_company).",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "delete_company",
      "title": "Usuń firmę",
      "description": "NIEODWRACALNE: usuwa firmę z panelu razem z jej dokumentami, kontrahentami i integracjami (dane w Systim i KSeF zostają). Wywołuj wyłącznie na wyraźne polecenie użytkownika; confirm_tax_id musi być NIP-em tej firmy, a confirm_name jej dokładną nazwą.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "lookup_company_by_nip",
      "title": "Sprawdź NIP w rejestrach",
      "description": "Dane firmy z Białej Listy VAT (MF) i rejestru NIP: nazwa, adres, status VAT, rachunki. Używaj przed dodaniem firmy albo kontrahenta.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "check_vat_registry",
      "title": "Sprawdź firmę w Białej Liście VAT",
      "description": "Odpytuje Białą Listę VAT o status firmy z konta i zapisuje wynik przy firmie (vat_registry_status). Nie zmienia profilu podatkowego — przy niezgodności poinformuj użytkownika.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_dashboard_summary",
      "title": "Podsumowanie finansów firmy",
      "description": "Liczby z pulpitu: przychody i koszty, należności i zobowiązania (także przeterminowane), VAT należny i do odliczenia, dokumenty do sprawdzenia, sprzedaż bez KSeF oraz zestawienie miesięczne.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_profile",
      "title": "Profil konta",
      "description": "Imię i nazwisko, e-mail, plan i stan abonamentu połączonego konta.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "update_profile",
      "title": "Zmień profil konta",
      "description": "Zmienia imię i nazwisko na koncie. Hasła, e-maila i 2FA agent nie zmienia — to robi użytkownik w panelu.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_documents",
      "title": "Lista dokumentów",
      "description": "Faktury sprzedażowe i kosztowe firmy, najnowsze pierwsze. Filtry: rodzaj, status (draft, ocr_review, ready, posted, failed…), źródło (ksef, systim, ocr, manual, stripe), zakres dat wystawienia albo sprzedaży, kontrahent, numer KSeF, fragment numeru. Zwraca kwoty w złotych, status księgowania, płatności i KSeF. To lista panelu — pełny rejestr KSeF (także faktury nie zaimportowane) daje list_ksef_register, a rejestry Systim systim_list_invoices.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_document",
      "title": "Szczegóły dokumentu",
      "description": "Jeden dokument z pozycjami, kontrahentem, uwagami walidacji, stanem księgowania, płatności i KSeF (numer KSeF, UPO, błąd odrzucenia).",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_document_pdf",
      "title": "PDF dokumentu",
      "description": "Wydruk faktury jako PDF (z programu księgowego albo złożony z XML-a KSeF), zakodowany base64.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "upload_document",
      "title": "Wgraj fakturę kosztową (OCR)",
      "description": "Wgrywa skan albo PDF faktury kosztowej i odczytuje go (OCR z AI): dostawca, numer, daty, kwoty, kategoria. Nie księguje — gdy wynik ma requires_review albo blokujące uwagi, pokaż je użytkownikowi, popraw przez update_document i dopiero wtedy wywołaj post_document. Maks. 10 MB, PDF/JPG/PNG/WEBP.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "update_document",
      "title": "Popraw dane dokumentu",
      "description": "Poprawia dane dokumentu, który NIE jest jeszcze zaksięgowany (status draft, ocr_review, ready albo failed): numer, daty, termin, metodę płatności, kategorię kosztu, opis, kontrahenta. Zaksięgowaną fakturę sprzedaży zmienia się przez edit_invoice albo correct_invoice. mark_ready: true przestawia dokument na „gotowy do księgowania”.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "void_document",
      "title": "Anuluj niezaksięgowany dokument",
      "description": "Oznacza w panelu jako anulowany dokument, który nie trafił do programu księgowego ani do KSeF (np. duplikat skanu). Zaksięgowany dokument wycofuje się przez unpost_document.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "refresh_document",
      "title": "Odśwież dokument z programu księgowego",
      "description": "Pobiera z Systim aktualny stan jednego dokumentu. Dokument bez numeru KSeF: nadpisuje w panelu nagłówek, kwoty, kontrahenta, rozliczenie i pozycje stanem z Systim. Dokument z KSeF: treść faktury (numer, daty, kontrahent, netto/VAT/brutto, waluta, kurs, pozycje) ZOSTAJE z KSeF — Systim trzyma ją jako wartość księgową (zakup walutowy w złotych, faktura rozliczeniowa kwotą P_15), więc z Systim przychodzi tylko rozliczenie, termin i forma płatności oraz kategoria kosztu. Różnice zwraca w ksef_differences; kwotę porównuje po kursie z faktury (ROZ: z P_15), a rzeczywisty rozjazd zapisuje jako blokującą uwagę ksef_data_divergence. Nie poprawia faktury z KSeF — sprzedaż koryguje correct_invoice, zakup koryguje sprzedawca.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "import_from_systim",
      "title": "Importuj dokumenty z Systim",
      "description": "Pobiera do panelu faktury wystawione albo zaewidencjonowane bezpośrednio w Systim w podanym okresie (domyślnie bieżący i poprzedni miesiąc). Nie zmienia niczego w Systim.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "preview_invoice",
      "title": "Sprawdź fakturę przed wystawieniem",
      "description": "Walidacja faktury bez zapisywania: sumy per stawka, dane nabywcy, profil VAT firmy, prognoza numeru z Systim. Zwraca listę uwag (severity: blocking/warning/info). Wywołaj przed create_sales_invoice.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "create_sales_invoice",
      "title": "Wystaw fakturę sprzedaży",
      "description": "Tworzy fakturę sprzedaży w panelu. Z post: true (domyślnie) od razu księguje ją w programie księgowym (Systim nadaje numer) — to zapis w księgach klienta, więc przed wywołaniem pokaż użytkownikowi nabywcę, pozycje i kwoty. Wysyłka do KSeF to osobny krok: send_to_ksef. Daty domyślnie dziś, termin wg ustawień firmy. Faktura za prowizję albo inną usługę rozliczaną okresowo: sale_date = ostatni dzień okresu, którego dotyczy (okres wpisz w opis pozycji). Faktura opłacona (kompensata, wypłata): po zaksięgowaniu register_payment z faktyczną datą. Najpierw preview_invoice.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "create_purchase_invoice",
      "title": "Zaewidencjonuj fakturę kosztową",
      "description": "Ręczne wprowadzenie faktury kosztowej (bez skanu). Podaj dostawcę, numer, daty, kwoty i kategorię kosztu Systim: 1 towary handlowe, 2 koszty uboczne zakupu, 3 wynagrodzenia, 4 faktura zaliczkowa, 5 media i telekomunikacja, 6 pojazd (paliwo, serwis), 7 wyposażenie, 8 środki trwałe, 9 opłaty bankowe, 10 delegacja, 12 najem, 13 WNiP, 14 ulepszenie ŚT, 15 samochód osobowy, 16 materiały, 17 samochód ciężarowy, 18 leasing, 19 dowód wewnętrzny, 20 zakup od rolnika (RR), 21 inny wydatek, 22 usługi, 23 pro forma, 24 ulepszenie WNiP. Z post: true od razu księguje w Systim.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "post_document",
      "title": "Zaksięguj dokument",
      "description": "Wysyła gotowy dokument (status ready albo failed) do programu księgowego (Systim). To zapis w księgach firmy — przed wywołaniem upewnij się, że użytkownik zatwierdził dane. Zwraca numer nadany przez Systim albo uwagi blokujące.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "unpost_document",
      "title": "Wycofaj dokument z księgowości",
      "description": "NIEODWRACALNE w Systim: usuwa z programu księgowego zaksięgowany dokument, jego płatności i zapisy w księdze, a w panelu oznacza go jako anulowany. Niedostępne dla faktury sprzedaży wysłanej już do KSeF (tam tylko correct_invoice). Wymaga powodu i wyraźnej zgody użytkownika.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "register_payment",
      "title": "Zarejestruj płatność",
      "description": "Rejestruje wpłatę (sprzedaż) albo zapłatę (koszt) — całą albo częściową — w programie księgowym i w panelu. Kwota w walucie dokumentu. paid_at to FAKTYCZNA data rozliczenia, nie dzisiejsza: prowizja rozliczona kompensatą (rozliczenie saldami) — ostatni dzień okresu, którego dotyczy; wypłata przelewem — dzień realizacji wypłaty (z potwierdzenia albo wyciągu). Gdy daty nie znasz, zapytaj użytkownika. Data trafia do KSeF jako DataZaplaty, więc rejestruj płatność przed send_to_ksef. Płatność rozlicza fakturę — nie jest drugim kosztem ani przychodem.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "check_invoice_edit",
      "title": "Czy fakturę można edytować",
      "description": "Sprawdza zaksięgowaną fakturę sprzedaży: czy jest w KSeF i co wolno z nią zrobić — edycję (edit_invoice) czy tylko korektę (correct_invoice).",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "edit_invoice",
      "title": "Edytuj zaksięgowaną fakturę sprzedaży",
      "description": "Zmienia fakturę sprzedaży w programie księgowym (daty, termin, płatność, pozycje), gdy check_invoice_edit zwrócił, że edycja jest dozwolona (faktura poza KSeF i niedoręczona). confirm_not_delivered: true potwierdza, że faktura nie trafiła jeszcze do nabywcy.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "correct_invoice",
      "title": "Wystaw fakturę korygującą",
      "description": "Wystawia korektę zaksięgowanej faktury: nowy, numerowany dokument w programie księgowym. lines to pozycje PO korekcie (pełny stan, nie różnica). Korektę faktury z KSeF trzeba potem wysłać send_to_ksef.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "send_to_ksef",
      "title": "Wyślij fakturę do KSeF",
      "description": "NIEODWRACALNE: wystawia zaksięgowaną fakturę sprzedaży (albo korektę) w Krajowym Systemie e-Faktur. Faktury przyjętej przez KSeF nie da się usunąć — zmienia ją tylko korekta. Działa, gdy firma ma wysyłkę z panelu (get_company → ksef_sending_via = panel). Przed wywołaniem pokaż użytkownikowi numer, nabywcę, kwotę, datę sprzedaży i — przy fakturze opłaconej — datę zapłaty (get_document → paid_on; bez niej KSeF dostanie DataZaplaty = data wystawienia) i poczekaj na zgodę. Wynik potwierdź przez get_ksef_status.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "get_ksef_status",
      "title": "Status faktury w KSeF",
      "description": "Sprawdza w KSeF wynik wysyłki: numer KSeF i UPO albo powód odrzucenia. Zapisuje wynik przy dokumencie.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "import_from_ksef",
      "title": "Pobierz faktury z KSeF",
      "description": "Pobiera z KSeF faktury kosztowe i sprzedażowe firmy, których jeszcze nie ma w panelu. KSeF ma limit zapytań na godzinę — nie wywołuj w pętli.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "list_ksef_register",
      "title": "Rejestr KSeF firmy",
      "description": "Pełny rejestr faktur firmy w KSeF — zakupy i sprzedaż, także te, których nie ma w panelu. Czyta kopię rejestru u nas (bez zapytań do KSeF, bez tworzenia dokumentów). Filtry: kierunek, data wystawienia albo przyjęcia w KSeF, NIP sprzedawcy lub nabywcy, numer, rodzaj (Vat, Kor, Zal, Roz, KorZal), obecność w panelu. Stronicowanie: limit/offset, total i has_more. coverage mówi, za jaki okres pobranie z KSeF jest kompletne i kiedy ostatnio działało — bez tego „brak w rejestrze” nic nie znaczy. Kwoty w walucie faktury, *_pln w złotych.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_ksef_invoice",
      "title": "Faktura z KSeF: XML, PDF i UPO",
      "description": "Oryginalny XML faktury z KSeF (FA) po numerze KSeF, opcjonalnie wydruk PDF, adres weryfikacyjny i UPO. Pierwsze pobranie faktury, której XML-a jeszcze nie mamy, zużywa jedno zapytanie z limitu KSeF (64/h) — plik zostaje u nas, kolejne odczyty są darmowe. Nie tworzy dokumentu w panelu. UPO istnieje tylko dla faktur wysłanych z panelu: nabywca UPO nie dostaje, a faktury wysłane innym programem mają UPO u niego.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_sync_status",
      "title": "Stan pobierania i zgodności źródeł",
      "description": "Aktualność i kompletność danych: do kiedy pobrano KSeF (zakupy i sprzedaż osobno), od kiedy rejestr jest pełny, kiedy ostatnio działał import z Systim, ostatnie błędy, oraz liczniki rozjazdów panel↔Systim↔KSeF (brak w Systim, sprzedaż bez KSeF, tylko w KSeF, tylko w Systim). Wywołaj przed uzgadnianiem.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_sync_conflicts",
      "title": "Konflikty importu KSeF",
      "description": "Faktury z KSeF, których panel nie dopasował jednoznacznie do dokumentów — do wyjaśnienia z użytkownikiem.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "resolve_sync_conflict",
      "title": "Zamknij konflikt importu",
      "description": "Zamyka zgłoszenie z list_sync_conflicts po decyzji użytkownika — jak przycisk w karcie Dokumenty. document_id wskazuje dokument, do którego faktura należy (pomiń, gdy żaden). Zgłoszenie zostaje jako ślad; kolejny przebieg importu przetworzy fakturę na nowo.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "systim_accounting_setup",
      "title": "Forma księgowości w Systim",
      "description": "Sprawdza w samym Systim, czy firma ma pełną księgowość (lata obrachunkowe: id i daty), i porównuje z profilem w panelu (tax_form). Wywołaj, zanim zmienisz tax_form albo zaczniesz czytać księgę — nie zgaduj formy z nazwy spółki. Tylko odczyt.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "systim_list_invoices",
      "title": "Rejestr faktur w Systim",
      "description": "Faktury sprzedaży albo zakupów wprost z Systim (nie z kopii w panelu), miesiąc po miesiącu. Sprzedaż Systim filtruje po dacie wystawienia, zakupy po dacie WPROWADZENIA do ewidencji (bywa ustawiana wstecz albo później). windows podaje liczność każdego miesiąca — listy Systim nie mają stronicowania, okno z podejrzanie okrągłą liczbą ma possibly_truncated. Pokazuje osobno systim_id faktury, kontrahenta, NIP i numer KSeF (gdy Systim go podaje). Nic nie importuje.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "systim_list_ledger",
      "title": "Księga w Systim: dziennik, KPiR, ryczałt",
      "description": "Wpisy księgi firmy z Systim w okresie: księgi handlowe (kh — dziennik z dekretami Wn/Ma), KPiR albo ewidencja ryczałtu. Domyślnie księga wg tax_form z panelu. with_decrees: true dociąga dekret każdego wpisu KH (konto, nazwa konta, kwota po stronie Wn/Ma) — wolniejsze, do 150 wpisów. Każdy wpis ma osobny id wpisu i — gdy Systim go podaje — id powiązanej faktury. fields_seen pokazuje pola, które przyszły z Systim. Nic nie zmienia.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "systim_list_payments",
      "title": "Płatności w Systim",
      "description": "Płatności zarejestrowane w Systim w okresie (osobny systim_id płatności), z rodzajem: dokument sprzedaży, zakupu, inny przychód, inny rozchód. with_links: true dociąga, które faktury (systim_id faktury) i jaką kwotą płatność rozlicza — do 150 płatności. Płatność to rozliczenie, nie drugi koszt ani przychód. Systim nie ma osobnych rozrachunków; to jest najbliższe źródło.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "systim_get_record",
      "title": "Rekord z Systim",
      "description": "Jeden rekord wprost z Systim po jego ID: faktura sprzedaży albo zakupu (nagłówek i pozycje), wpis księgi (z dekretem Wn/Ma przy KH) albo płatność (z powiązanymi fakturami). Tylko odczyt.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "systim_export_report",
      "title": "Raport z Systim: JPK_KR, bilans, RZiS",
      "description": "Plik wygenerowany przez Systim: jpk_kr (pełna księgowość — dziennik, zapisy na kontach Wn/Ma i ZOiS za okres; summary zawiera konta z obrotami/saldem, czyli plan kont w zakresie, w jakim API go pokazuje), balance_sheet albo profit_and_loss (dla roku obrachunkowego — id z systim_accounting_setup). JPK_KR wymaga tax_office_id; bez niego podaj tax_office_search (nazwa urzędu), a narzędzie zwróci pasujące urzędy. Niczego nie składa do urzędu.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "reconcile_sources",
      "title": "Uzgodnij KSeF, panel, Systim i księgę",
      "description": "Raport uzgodnienia faktur firmy w okresie (po dacie wystawienia): rejestr KSeF ↔ dokumenty panelu ↔ rejestry faktur Systim ↔ wpisy księgi ↔ płatności. Dopasowanie po numerze KSeF, potem NIP kontrahenta + numer faktury. Sprawdza nabywcę, walutę, kwoty, daty, duplikaty (także podwójne wpisy w księdze — wpisy zapłat się nie liczą), korekty i zaliczki. Oddziela missing_in_panel (luka panelu) od missing_in_books (faktury nie ma w Systim). Zwraca liczności każdego źródła, okna odczytu, kompletność (complete), listę braków i rozbieżności oraz jawne ograniczenia. Wyłącznie odczyt — nic nie importuje, nie księguje, nie zmienia konfiguracji. Może trwać do minuty. Naprawy: propose_change → zgoda użytkownika → apply_change.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "propose_change",
      "title": "Zaproponuj zmianę (plan do zatwierdzenia)",
      "description": "Pierwszy krok bezpiecznej naprawy: NIC nie zmienia, tylko zapisuje plan — stan PRZED (panel i, gdy dokument jest w Systim, odczyt z Systim), spodziewany stan PO, źródła, kwoty, daty, ostrzeżenia i blokady (np. faktura już zaksięgowana = podwójny import, ta sama korekta już wystawiona, płatność ponad kwotę). Pokaż plan użytkownikowi i dopiero po jego zgodzie wywołaj apply_change z plan_id. action i args to nazwa i argumenty narzędzia, które wykona zmianę (np. update_document z sale_date). Wysyłka do KSeF nie wchodzi w plan — to zawsze osobny send_to_ksef z osobną zgodą. Plan ważny 24 godziny.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "apply_change",
      "title": "Wykonaj zatwierdzony plan zmiany",
      "description": "Wykonuje DOKŁADNIE plan z propose_change — raz. Wymaga confirmed: true po wyraźnej zgodzie użytkownika na ten plan. Odmawia, gdy dokument zmienił się od propozycji (plan nieaktualny — zaproponuj ponownie), plan wygasł albo ma blokady. Ponowne wywołanie zwraca wynik pierwszego wykonania zamiast powtarzać zmianę. Po zapisie obowiązkowo czyta wynik kontrolnie (panel, a przy dokumencie w Systim — Systim) i porównuje ze stanem spodziewanym. Zapis w księgach klienta.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "list_change_plans",
      "title": "Plany zmian i ich wyniki",
      "description": "Plany zmian agentów: zaproponowane, wykonane, nieaktualne — ze stanem przed, spodziewanym po, wynikiem i odczytem kontrolnym. Ślad wszystkich napraw zrobionych przez agentów.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_counterparties",
      "title": "Kontrahenci",
      "description": "Klienci i dostawcy firmy. search szuka w nazwie i NIP-ie. Zwraca id do faktur.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "create_counterparty",
      "title": "Dodaj kontrahenta",
      "description": "Dodaje klienta albo dostawcę. Dla firm z Polski najpierw lookup_company_by_nip i przepisz nazwę i adres z rejestru. Zwraca id kontrahenta.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "update_counterparty",
      "title": "Zmień kontrahenta",
      "description": "Zmienia dane kontrahenta. Podaj tylko pola do zmiany.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "delete_counterparty",
      "title": "Usuń kontrahenta",
      "description": "Usuwa kontrahenta z panelu (nie z Systim). Kontrahenta z dokumentami nie da się usunąć.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "get_integrations",
      "title": "Stan integracji",
      "description": "Systim (konto, weryfikacja), KSeF (środowisko, NIP kontekstu, uprawnienia tokenu, tryb wysyłki) i AI Agent HUB dla firmy. Bez haseł i tokenów.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "connect_systim",
      "title": "Podłącz program księgowy Systim",
      "description": "Zapisuje i sprawdza dane API Systim firmy (identyfikator konta z adresu <id>.systim.pl, e-mail i hasło API). Hasło jest szyfrowane i nigdy nie wraca. test_only: true tylko sprawdza połączenie. Hasło API podaje użytkownik — nie zgaduj go i nie zapisuj w rozmowie dłużej, niż to konieczne.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "connect_ksef",
      "title": "Podłącz KSeF",
      "description": "Zapisuje token KSeF wygenerowany przez użytkownika w Aplikacji Podatnika i sprawdza jego uprawnienia. Token jest szyfrowany i nigdy nie wraca. Środowisko prod = prawdziwe faktury.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "manage_ksef",
      "title": "Zarządzaj integracją KSeF",
      "description": "action = verify (sprawdź token i uprawnienia), status, disconnect (usuń token z panelu) albo set_sending (kto wysyła faktury do KSeF: panel, systim, none). set_sending = panel włącza prawne wystawianie faktur z panelu i wymaga confirmed: true po wyraźnej zgodzie użytkownika.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "get_subscription",
      "title": "Abonament i zużycie",
      "description": "Plan, stan płatności, data ważności i liczba dokumentów przetworzonych w bieżącym miesiącu (per firma).",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_billing_invoices",
      "title": "Faktury za abonament",
      "description": "Faktury VAT wystawione na to konto za abonament Centrum Finansowe.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_billing_link",
      "title": "Link do płatności lub zmiany planu",
      "description": "Zwraca link dla człowieka: portal klienta Stripe (karta, faktury, anulowanie) albo — z plan — stronę zakupu planu Start, Growth lub Scale. Agent nie płaci; płatność kończy użytkownik w przeglądarce.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    }
  ]
}
