ucetka-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UCETKA_OUT | No | Directory for issued invoice PDFs. | |
| UCETKA_HOME | No | Directory for the company profile, records, and advances (defaults to ~/.ucetka). | |
| UCETKA_REPORTS | No | Directory for VAT filings, control statements, EC sales lists, and the income and expense book. | |
| UCETKA_RECEIVED | No | Directory for received invoices (PDF, ISDOC). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_supplierB | Dodavatel (fakturující) ze supplier.yaml včetně výchozího účtu. |
| list_customersA | Adresář odběratelů (customers.yaml). customer_id použij v issue_invoice. |
| lookup_companyA | Najde firmu v ARES podle IČO — název, sídlo, DIČ, registrace k DPH. |
| add_customerA | Přidá odběratele do adresáře podle IČO (data z ARES). Existující záznam nepřepíše. |
| peek_invoice_numberA | Příští číslo faktury podle evidence (nic nerezervuje). |
| issue_invoiceA | Vystaví fakturu: PDF/A-3a s ISDOC 6.0.2 a QR Platbou+F, uloží ji do evidence a vrátí shrnutí. Před vystavením si ověř odběratele (list_customers / lookup_company) a částky s uživatelem. |
| list_invoicesC | Vydané faktury z evidence, včetně těch po splatnosti. |
| get_invoiceA | Detail faktury z evidence: položky, platební údaje, SPAYD řetězec QR kódu a cesta k PDF. |
| mark_paidB | Označí faktury jako zaplacené (např. podle výpisu z banky). |
| export_invoice_pohodaB | Uloží fakturu jako Pohoda XML (windows-1250, validováno XSD) vedle PDF. |
| draft_invoice_emailA | Otevře v Mail.app KONCEPT e-mailu s PDF fakturou v příloze. Nic neodesílá — odeslání je na uživateli. |
| export_vat_returnA | Přiznání k DPH (DPHDP3), kontrolní hlášení (DPHKH1) a při službách do EU i souhrnné hlášení (DPHSHV) pro EPO. Uloží do ~/Documents/Účetnictví/Přehledy//_Q_přehledy/{DPH,KH,SH}/. Nic nepodává — soubory se nahrají ručně na Moje daně (EPO → Načíst soubor → Kontrola → Odeslat). |
| tax_overviewA | Jak jsem na tom: příjmy, odhad daně a pojištění vs. zálohy, DPH za období, nezaplacené faktury, flagy, termíny. Nejdřív automaticky načte nové faktury ze složek Vydané/Přijaté faktury. Grafický přehled: |
| sync_invoicesA | Načte nové PDF z Vydaných faktur (ISDOC) a Přijatých faktur (ISDOC, jinak Alza) do evidence. Zbylé doklady hned zpracuj: list_import_issues → přečti PDF → add_expense / add_manual_invoice. |
| list_import_issuesA | Doklady, které import nepřečetl (bez ISDOC, cizí formát, zahraniční dodavatel). U každého přečti PDF z uvedené cesty, údaje (dodavatel, číslo, DUZP, rekapitulace DPH, země sídla) zapiš přes add_expense s pdf_path, resp. add_manual_invoice u vydaných. Nejasné věci (reverse charge, soukromé použití) se zeptej uživatele, nehádej. |
| add_expenseB | Ručně zapíše přijatou fakturu (výdaj) — hlavně doklady, které import neumí přečíst. |
| mark_expense_paidA | Označí přijatou fakturu (výdaj) jako zaplacenou — pro daňovou evidenci se skutečnými výdaji. |
| export_bookB | Kniha příjmů a výdajů (daňová evidence) za rok jako CSV + PDF do složky Přehledy//. |
| add_manual_invoiceA | Zapíše do evidence vydanou fakturu, kterou import nepřečetl (PDF už existuje, nic se negeneruje). |
| record_paymentB | Zapíše zaplacenou zálohu / doplatek (daň, sociální, zdravotní, DPH). |
| advance_scheduleA | Rozpis měsíčních záloh ČSSZ: které měsíce jsou zaplacené / po splatnosti, a odhad zálohy na příští rok. |
| cancel_invoiceA | Stornuje vydanou fakturu (zůstane v evidenci, nepočítá se). Jen pokud ji uživatel výslovně ruší. Pokud už byla doručena odběrateli, nestornuj — vystav dobropis přes issue_credit_note. |
| issue_credit_noteA | Vystaví opravný daňový doklad (dobropis) k vydané faktuře — PDF/A-3 s ISDOC (DocumentType 2), bez QR. Použij místo storna, když už faktura odešla odběrateli. Částky na dobropisu jsou kladné, v přehledech a v přiznání DPH se odečítají v období data opravy. |
| remove_expenseA | Odebere přijatou fakturu z evidence — jen když ji uživatel výslovně smazal / nechce ji evidovat. |
| open_dashboardA | Otevře grafický přehled (dashboard) v prohlížeči. Běží jako služba na pozadí (LaunchAgent). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 25 tools
Most tools map to distinct resources/actions: supplier/customer lookup, invoice issuance, payment marking, expense handling, exports, and dashboarding are clearly separated. Mild overlap exists between tax_overview/open_dashboard and between issue_invoice/add_manual_invoice, but the descriptions clarify when each should be used.
The set mostly follows a predictable snake_case verb_noun convention: get_supplier, list_customers, issue_invoice, mark_paid, export_vat_return, etc. Minor deviations like tax_overview (noun phrase) and advance_schedule (less explicit verb/object) are noticeable but not disruptive.
The accounting domain is broad enough to justify many operations, but 25 tools sits at the heavy end of the scale. Some capabilities could likely be consolidated, especially dashboard/overview and import/tax reporting helpers, making the surface feel somewhat large.
Core invoice lifecycle and tax workflows are well covered: issue, list, get, mark paid, cancel, credit note, VAT export, book export, and imports are present. Minor gaps remain, notably no direct list/get tool for expenses and no customer update/delete, but agents can work around these via dashboard/export flows.