{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-05T22:41:32.401Z","url":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp","markdownUrl":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp.md","server":{"slug":"eu-humblecode-uol","name":"UOL Účetnictví (unofficial)","registryName":"eu.humblecode/uol","description":"Invoices, receivables, VAT, ledger and documents from UOL Účetnictví (Czech online accounting)","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"uol-mcp","type":"mcpb","identifier":"https://github.com/jakubbegera/uol-mcp/releases/download/v0.6.1/uol-mcp.mcpb","withdrawn":false,"url":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp","version":null,"transport":"stdio","scoredAt":"2026-11-05T14:03:18.273Z"},"score":{"total":49,"tier":"low","status":"scored","weekDelta":null,"history":[{"date":"2026-11-05","total":49}]},"categories":[{"name":"Supply Chain Security","score":25,"verdict":"partial","reasons":["No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.","Known CVEs were checked across the 6 of 6 dependencies we could resolve, so this covers what we could see, not the whole tree.","No install/post-install scripts declared.","0 of 6 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_inconclusive","args":{"reason":"ecosystem_unsupported"}},{"code":"cve.tree_partial","args":{"seen":"6","resolved":"6"}},{"code":"installscript.none","args":{}},{"code":"dephealth.assessed","args":{"deps":"6","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":48,"verdict":"fail","reasons":["Source repository is publicly reachable at the declared URL.","Provenance check failed: no build-provenance attestation is published.","Clear OSI-approved license (MIT).","Actively maintained (last published 0 days ago).","Publishes a security disclosure policy (SECURITY.md)."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.none","args":{}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"0"}},{"code":"disclosure.present","args":{}}]},{"name":"Schema Quality & AI Usability","score":78,"verdict":"fail","reasons":["100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).","AI-judged instruction clarity (good).","Context-footprint check failed: tool/resource definitions use about 2569 tokens (~128/item across 20 items; 18 tools + 2 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.descriptions","args":{"pct":"100"}},{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_heavy","args":{"avg":"128","items":"20","tools":"18","tokens":"2569","resources":"2"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":0,"verdict":"unverified","reasons":["Stability observed for 0 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"0"}}]},{"name":"Tool Coverage","score":94,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","78% of tool parameters carry a description.","Structured output schemas are declared (100% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"78"}},{"code":"toolquality.output_present","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"18"}},{"code":"toolsafety.manipulation_clean","args":{"units":"20","judged":"20"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28)."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}}]}],"inconclusive":["No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.","Stability observed for 0 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"malware":[],"components":[{"slug":"uol-mcp","type":"mcpb","identifier":"https://github.com/jakubbegera/uol-mcp/releases/download/v0.6.1/uol-mcp.mcpb","withdrawn":false,"score":49,"current":true,"url":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp","markdownUrl":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp.md"},{"slug":"uol-mcp-2","type":"npm","identifier":"uol-mcp","withdrawn":false,"score":55,"current":false,"url":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp-2","markdownUrl":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp-2.md"},{"slug":"ghcr-io-jakubbegera-uol-mcp","type":"oci","identifier":"ghcr.io/jakubbegera/uol-mcp","withdrawn":false,"score":41,"current":false,"url":"https://verifymcp.io/servers/eu-humblecode-uol/ghcr-io-jakubbegera-uol-mcp","markdownUrl":"https://verifymcp.io/servers/eu-humblecode-uol/ghcr-io-jakubbegera-uol-mcp.md"}],"facts":[{"label":"Registry","value":"mcpb"},{"label":"Package","value":"https://github.com/jakubbegera/uol-mcp/releases/download/v0.6.1/uol-mcp.mcpb"},{"label":"Transport","value":"stdio"},{"label":"SHA-256","value":"6b0b6987873cf0d49226af51fc7ecbcdb0c905fe6f250096d8b7422891eec604"}],"install":{"available":true,"bundleSha256":"6b0b6987873cf0d49226af51fc7ecbcdb0c905fe6f250096d8b7422891eec604"},"tools":[{"name":"get_company","title":"Company details","description":"The accounting entity of this UOL tenant: name, IČO, DIČ, address and VAT filing period. Also a quick check that uol-mcp is connected.","inputs":[],"outputs":[{"name":"address","type":"object","required":true,"description":null},{"name":"company_number","type":"string|null","required":true,"description":"IČO"},{"name":"email","type":"string|null","required":true,"description":null},{"name":"legal_entity","type":"boolean|null","required":true,"description":"true = company (právnická osoba), false = sole trader"},{"name":"name","type":"string|null","required":true,"description":null},{"name":"phone","type":"string|null","required":true,"description":null},{"name":"register","type":"string|null","required":true,"description":null},{"name":"tenant","type":"object","required":true,"description":null},{"name":"valid_from","type":"string|null","required":true,"description":null},{"name":"vat_period","type":"string","required":true,"description":null},{"name":"vatin","type":"string|null","required":true,"description":"DIČ"},{"name":"web","type":"string|null","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":44},{"name":"list_codebook","title":"List codebook","description":"Reference data (číselníky) used by invoices and documents: currencies, countries, departments (střediska), contracts (zakázky), price lists, product categories, predefined texts, document templates, payment rules, own bank accounts, petty cashes (pokladny), document tags and products (the product_id invoice lines need). Records are returned as UOL sends them, minus audit fields.","inputs":[{"name":"kind","type":"string","required":true,"description":null},{"name":"limit","type":"integer","required":false,"description":"Rows per page (max 250)"},{"name":"page","type":"integer","required":false,"description":"Page number, starting at 1"}],"outputs":[{"name":"items","type":"array","required":true,"description":null},{"name":"kind","type":"string","required":true,"description":null},{"name":"pagination","type":"object","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":126},{"name":"search_sales_invoices","title":"Search issued invoices","description":"Search issued (sales) invoices — vydané faktury — newest first. Each row includes payment status from UOL receivables. Use tax_date_* (DUZP) for accounting-period questions, issue_date_* for \"issued in\". Drafts and cancelled invoices are listed too; check status. For \"who owes me money\" prefer list_receivables.","inputs":[{"name":"buyer_id","type":"string","required":false,"description":"Contact id from search_contacts"},{"name":"due_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"due_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"issue_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"issue_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"limit","type":"integer","required":false,"description":"Rows per page (max 100)"},{"name":"number","type":"string","required":false,"description":"Partial match of the invoice number"},{"name":"page","type":"integer","required":false,"description":"Page number, starting at 1"},{"name":"query","type":"string","required":false,"description":"Full-text: invoice number, buyer name or text"},{"name":"tax_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"tax_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"total_max","type":"number","required":false,"description":null},{"name":"total_min","type":"number","required":false,"description":"Total including VAT"},{"name":"type","type":"string","required":false,"description":null},{"name":"variable_symbol","type":"string","required":false,"description":null}],"outputs":[{"name":"invoices","type":"array","required":true,"description":null},{"name":"pagination","type":"object","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":273},{"name":"get_sales_invoice","title":"Get issued invoice","description":"One issued (sales) invoice with line items, VAT, payment symbols, own bank account and payments received. Use export_sales_invoice for the PDF or ISDOC. Earlier invoices to the same buyer show how they are usually issued (DUZP, due days, products, line texts, bank account) — a template for a new one.","inputs":[{"name":"invoice_id","type":"string","required":true,"description":"invoice_id from search_sales_invoices"}],"outputs":[{"name":"bank_account_id","type":"string|null","required":true,"description":"Own bank account the buyer pays to (list_codebook my_bank_accounts)"},{"name":"buyer","type":"object","required":true,"description":null},{"name":"constant_symbol","type":"string|null","required":true,"description":null},{"name":"contract_id","type":"string|null","required":true,"description":"Contract (zakázka), if any"},{"name":"currency","type":"string|null","required":true,"description":null},{"name":"department_id","type":"string|null","required":true,"description":null},{"name":"due_date","type":"string|null","required":true,"description":null},{"name":"exchange_rate","type":"number|null","required":true,"description":null},{"name":"external_id","type":"string|null","required":true,"description":null},{"name":"invoice_id","type":"string","required":true,"description":"Internal id, usable with get_sales_invoice"},{"name":"issue_date","type":"string|null","required":true,"description":null},{"name":"items","type":"array","required":true,"description":null},{"name":"linked_invoice_id","type":"string|null","required":true,"description":"E.g. the original invoice of a corrective invoice"},{"name":"note","type":"string|null","required":true,"description":null},{"name":"number","type":"string|null","required":true,"description":"Evidence number shown on the invoice"},{"name":"payment","type":"object","required":true,"description":null},{"name":"payment_method","type":"string|null","required":true,"description":null},{"name":"payments","type":"array","required":true,"description":null},{"name":"specific_symbol","type":"string|null","required":true,"description":null},{"name":"status","type":"string","required":true,"description":"draft = koncept (UOL \"valid\"), issued = vystavená (\"confirmed\"), cancelled = storno (\"invalid\")"},{"name":"tax_date","type":"string|null","required":true,"description":"DUZP — taxable supply date"},{"name":"text","type":"string|null","required":true,"description":"Introductory text printed on the invoice"},{"name":"total","type":"number|null","required":true,"description":"Total including VAT (Celkem s DPH)"},{"name":"total_without_vat","type":"number|null","required":true,"description":"Tax base (Celkem bez DPH)"},{"name":"type","type":"string|null","required":true,"description":null},{"name":"variable_symbol","type":"string|null","required":true,"description":null},{"name":"vat","type":"number|null","required":true,"description":"Sum of VAT amounts"},{"name":"vat_amounts","type":"array","required":true,"description":"UOL vat1..vat3 amounts in rate order"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":93},{"name":"search_purchase_invoices","title":"Search received invoices","description":"Search received (purchase) invoices — přijaté faktury. UOL ignores issue-date filters on this endpoint, so filter by tax_date_* (DUZP) or received_date_*. The UOL API exposes no payment status for purchase invoices.","inputs":[{"name":"currency","type":"string","required":false,"description":"ISO code, e.g. EUR"},{"name":"due_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"due_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"limit","type":"integer","required":false,"description":"Rows per page (max 100)"},{"name":"number","type":"string","required":false,"description":"Partial match of the supplier's invoice number"},{"name":"page","type":"integer","required":false,"description":"Page number, starting at 1"},{"name":"query","type":"string","required":false,"description":"Full-text: invoice number, supplier name or text"},{"name":"received_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"received_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"seller_id","type":"string","required":false,"description":"Contact id from search_contacts"},{"name":"tax_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"tax_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"total_max","type":"number","required":false,"description":null},{"name":"total_min","type":"number","required":false,"description":null},{"name":"type","type":"string","required":false,"description":null},{"name":"variable_symbol","type":"string","required":false,"description":null}],"outputs":[{"name":"invoices","type":"array","required":true,"description":null},{"name":"pagination","type":"object","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":263},{"name":"get_purchase_invoice","title":"Get received invoice","description":"One received (purchase) invoice with line items, VAT and payment symbols.","inputs":[{"name":"invoice_id","type":"string","required":true,"description":"invoice_id from search_purchase_invoices"}],"outputs":[{"name":"constant_symbol","type":"string|null","required":true,"description":null},{"name":"currency","type":"string|null","required":true,"description":null},{"name":"department_id","type":"string|null","required":true,"description":null},{"name":"due_date","type":"string|null","required":true,"description":null},{"name":"exchange_rate","type":"number|null","required":true,"description":null},{"name":"external_id","type":"string|null","required":true,"description":null},{"name":"invoice_id","type":"string","required":true,"description":"Internal id, usable with get_purchase_invoice"},{"name":"issue_date","type":"string|null","required":true,"description":null},{"name":"items","type":"array","required":true,"description":null},{"name":"note","type":"string|null","required":true,"description":null},{"name":"number","type":"string|null","required":true,"description":"Supplier's invoice number"},{"name":"payment_method","type":"string|null","required":true,"description":null},{"name":"received_date","type":"string|null","required":true,"description":null},{"name":"seller","type":"object","required":true,"description":null},{"name":"specific_symbol","type":"string|null","required":true,"description":null},{"name":"status","type":"string","required":true,"description":"draft = koncept (UOL \"valid\"), issued = vystavená (\"confirmed\"), cancelled = storno (\"invalid\")"},{"name":"tax_date","type":"string|null","required":true,"description":"DUZP — taxable supply date"},{"name":"total","type":"number|null","required":true,"description":"Total including VAT (Celkem s DPH)"},{"name":"total_without_vat","type":"number|null","required":true,"description":"Tax base (Celkem bez DPH)"},{"name":"type","type":"string|null","required":true,"description":null},{"name":"variable_symbol","type":"string|null","required":true,"description":null},{"name":"vat","type":"number|null","required":true,"description":"Sum of VAT amounts"},{"name":"vat_amounts","type":"array","required":true,"description":"UOL vat1..vat3 amounts in rate order"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":39},{"name":"export_sales_invoice","title":"Export issued invoice (PDF / ISDOC)","description":"Downloads an issued (sales) invoice rendered by UOL and saves it on the machine running uol-mcp. format=isdoc also returns the ISDOC XML (Czech e-invoice standard), which is readable line by line. ISDOC exists only for issued (confirmed) invoices. Received invoices cannot be exported through the API.","inputs":[{"name":"format","type":"string","required":false,"description":null},{"name":"invoice_id","type":"string","required":true,"description":"invoice_id from search_sales_invoices"}],"outputs":[{"name":"content_type","type":"string","required":true,"description":null},{"name":"file_name","type":"string","required":true,"description":null},{"name":"file_path","type":"string|null","required":true,"description":"Absolute path of the saved file on the machine running uol-mcp; null when the file is embedded in the result (HTTP transport)"},{"name":"format","type":"string","required":true,"description":null},{"name":"invoice_id","type":"string","required":true,"description":null},{"name":"size_bytes","type":"number","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":98},{"name":"list_receivables","title":"Receivables (who owes us)","description":"Receivables of issued (sales) invoices — pohledávky: totals per currency plus the matching invoices, most overdue first by default. Answers \"who owes me money\", \"what is overdue\", \"has customer X paid\". Covers sales invoices only: the UOL API exposes no payment status for received (purchase) invoices.","inputs":[{"name":"customer_id","type":"string","required":false,"description":"Contact id from search_contacts"},{"name":"due_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"due_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"issue_date_from","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"issue_date_to","type":"string","required":false,"description":"Date as YYYY-MM-DD"},{"name":"limit","type":"integer","required":false,"description":"Invoices to list; totals always cover every match"},{"name":"overdue_only","type":"boolean","required":false,"description":"Only unpaid invoices past their due date"},{"name":"sort","type":"string","required":false,"description":null},{"name":"state","type":"string","required":false,"description":null}],"outputs":[{"name":"as_of","type":"string","required":true,"description":"Today in Europe/Prague; overdue is computed against this date"},{"name":"invoices","type":"array","required":true,"description":null},{"name":"match_count","type":"number","required":true,"description":null},{"name":"totals","type":"array","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":"True when UOL had more rows than one call reads; narrow the filters"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":192},{"name":"search_contacts","title":"Search contacts","description":"Search customers and suppliers (kontakty / adresář) by name, IČO or DIČ. Returns contact_id values for the invoice and receivable filters.","inputs":[{"name":"company_number","type":"string","required":false,"description":"IČO"},{"name":"country","type":"string","required":false,"description":"ISO country code, e.g. CZ"},{"name":"include_hidden","type":"boolean","required":false,"description":null},{"name":"limit","type":"integer","required":false,"description":"Rows per page (max 100)"},{"name":"name","type":"string","required":false,"description":"Name as UOL matches it; for part of a name use query"},{"name":"page","type":"integer","required":false,"description":"Page number, starting at 1"},{"name":"query","type":"string","required":false,"description":"Full-text: name, contact id or note"},{"name":"taxable_person","type":"boolean","required":false,"description":"true = businesses only, false = private persons only"},{"name":"vatin","type":"string","required":false,"description":"DIČ, e.g. CZ12345678"}],"outputs":[{"name":"contacts","type":"array","required":true,"description":null},{"name":"pagination","type":"object","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":176},{"name":"get_contact","title":"Get contact","description":"One contact with all addresses, bank accounts and default payment terms.","inputs":[{"name":"contact_id","type":"string","required":true,"description":"contact_id, e.g. from search_contacts or an invoice"}],"outputs":[{"name":"addresses","type":"array","required":true,"description":null},{"name":"bank_accounts","type":"array","required":true,"description":null},{"name":"city","type":"string|null","required":true,"description":null},{"name":"company_number","type":"string|null","required":true,"description":"IČO"},{"name":"contact_id","type":"string","required":true,"description":"Usable with get_contact and as buyer_id / seller_id / customer_id filters"},{"name":"country","type":"string|null","required":true,"description":null},{"name":"days_till_due_date","type":"number|null","required":true,"description":"Default payment term in days"},{"name":"email","type":"string|null","required":true,"description":null},{"name":"external_id","type":"string|null","required":true,"description":null},{"name":"hidden","type":"boolean|null","required":true,"description":null},{"name":"name","type":"string|null","required":true,"description":null},{"name":"note","type":"string|null","required":true,"description":null},{"name":"taxable_person","type":"boolean|null","required":true,"description":"Business (osoba povinná k dani) vs private person"},{"name":"unreliable_payer","type":"boolean|null","required":true,"description":"Flagged as nespolehlivý plátce DPH"},{"name":"vat_payer","type":"boolean|null","required":true,"description":null},{"name":"vatin","type":"string|null","required":true,"description":"DIČ"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":41},{"name":"list_uploaded_documents","title":"List uploaded documents","description":"Documents uploaded to UOL for the accountant (nahrané doklady: receipts, received invoices as PDF/images), newest first. state=unprocessed lists what the accountant has not processed yet.","inputs":[{"name":"created_from","type":"string","required":false,"description":"Uploaded on or after this day (Prague time)"},{"name":"created_to","type":"string","required":false,"description":"Uploaded before this day (Prague time)"},{"name":"limit","type":"integer","required":false,"description":"Rows per page (max 100)"},{"name":"page","type":"integer","required":false,"description":"Page number, starting at 1"},{"name":"state","type":"string","required":false,"description":null}],"outputs":[{"name":"documents","type":"array","required":true,"description":null},{"name":"pagination","type":"object","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":117},{"name":"get_uploaded_document","title":"Get uploaded document","description":"One uploaded document with its original file name, tags and the bookkeeping records it was paired with. Pairings identify the record by type and internal gid, not by invoice number.","inputs":[{"name":"document_id","type":"string","required":true,"description":null}],"outputs":[{"name":"content_type","type":"string|null","required":true,"description":null},{"name":"created_at","type":"string|null","required":true,"description":null},{"name":"created_by","type":"string|null","required":true,"description":null},{"name":"document_id","type":"string","required":true,"description":null},{"name":"file_name","type":"string|null","required":true,"description":null},{"name":"format","type":"string|null","required":true,"description":null},{"name":"note","type":"string|null","required":true,"description":null},{"name":"pairings","type":"array","required":true,"description":null},{"name":"state","type":"string|null","required":true,"description":"unprocessed = waiting for the accountant, processed, error"},{"name":"tags","type":null,"required":true,"description":"Null when the UOL user may not read tags"},{"name":"uploaded_via","type":"string|null","required":true,"description":"web, api, an e-mail address or an OIDC client id"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":52},{"name":"download_uploaded_document","title":"Download uploaded document","description":"Saves the original file of an uploaded document on the machine running uol-mcp and returns its path.","inputs":[{"name":"document_id","type":"string","required":true,"description":null}],"outputs":[{"name":"content_type","type":"string","required":true,"description":null},{"name":"document_id","type":"string","required":true,"description":null},{"name":"file_name","type":"string","required":true,"description":null},{"name":"file_path","type":"string|null","required":true,"description":"Absolute path of the saved file on the machine running uol-mcp; null when the file is embedded in the result (HTTP transport)"},{"name":"size_bytes","type":"number","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":38},{"name":"api_get","title":"Raw UOL GET","description":"Read-only GET of any UOL REST path (spec: https://api.uol.cz/openapi.yaml) for data no other tool covers — e.g. /v1/accounting_records, /v1/bank_movements, /v1/products, /v1/warehouse/statuses, /v1/sales_orders. Returns the raw JSON (amounts as strings, invoice status \"valid\" = draft); large answers are cut to fit. Prefer the dedicated tools.","inputs":[{"name":"path","type":"string","required":true,"description":"Path under the API root starting with /v1/, e.g. /v1/products"},{"name":"query","type":"object","required":false,"description":"Query parameters, e.g. {\"page\": 1, \"per_page\": 50}"}],"outputs":[{"name":"data","type":null,"required":true,"description":null},{"name":"path","type":"string","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":155},{"name":"get_financial_overview","title":"Revenue, expenses and profit by month","description":"Revenue (výnosy, class 6), expenses (náklady, class 5) and profit per month from the general ledger — the same basis as the UOL web dashboard, so payroll, rent and other internal documents count, not just invoices. Amounts are net of VAT, in the home currency. The current month is still running, and months the accountant has not booked yet have booked=false — say so instead of reporting zero. Also returns the largest revenue and expense accounts (with names) for the whole window.","inputs":[{"name":"months","type":"integer","required":false,"description":"Months ending with the current one"}],"outputs":[{"name":"as_of","type":"string","required":true,"description":null},{"name":"booked_through","type":"string|null","required":true,"description":"Date of the latest revenue or expense posting: the ledger is booked up to here; later months are not booked yet"},{"name":"current_vs_previous","type":null,"required":true,"description":null},{"name":"expenses_by_account","type":"array","required":true,"description":null},{"name":"months","type":"array","required":true,"description":null},{"name":"revenue_by_account","type":"array","required":true,"description":null},{"name":"totals","type":"object","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":"True when the ledger had more postings than one call reads; use fewer months"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":131},{"name":"get_vat_overview","title":"VAT by filing period","description":"VAT (DPH) per filing period, newest first: output VAT, input VAT, amount to pay or excess deduction, due date. The filing period (monthly / quarterly) comes from the company settings. Closed periods use UOL's \"DPH\" closing document (exact). Open periods are estimated from issued invoices — output VAT by DUZP, input VAT by the later of DUZP and the receipt date: proformas skipped, corrective invoices counted as credit notes, internal documents and reverse charge not included.","inputs":[{"name":"periods","type":"integer","required":false,"description":"Number of periods; default 4 for monthly payers, 2 for quarterly"}],"outputs":[{"name":"as_of","type":"string","required":true,"description":null},{"name":"method","type":"string","required":true,"description":null},{"name":"periods","type":"array","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":null},{"name":"vat_period","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":139},{"name":"get_bank_balances","title":"Bank balances","description":"Balances of the company's own bank accounts, per account and summed per currency. UOL stores monthly opening-balance snapshots (1st of the month), not live balances; always quote the as_of date.","inputs":[{"name":"history","type":"boolean","required":false,"description":"Also return every snapshot, newest first (up to 120)"}],"outputs":[{"name":"accounts","type":"array","required":true,"description":null},{"name":"by_currency","type":"array","required":true,"description":null},{"name":"history","type":null,"required":true,"description":null},{"name":"note","type":"string","required":true,"description":null},{"name":"truncated","type":"boolean","required":true,"description":"True when UOL had more snapshots than one call reads"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":71},{"name":"get_business_snapshot","title":"Business snapshot","description":"\"How is the company doing?\" in one call: this month vs last month (revenue, expenses, profit, whether booked yet), the VAT period due next and the running one, unpaid and overdue receivables, uploaded documents waiting for the accountant, and bank balances. Sections that fail (e.g. missing permission) are null and listed in errors; sections read only partly are listed in incomplete. Use the dedicated tools for detail.","inputs":[],"outputs":[{"name":"as_of","type":"string","required":true,"description":null},{"name":"bank","type":null,"required":true,"description":"UOL stores monthly opening-balance snapshots (1st of the month), not live balances; always quote the as_of date."},{"name":"booked_through","type":"string|null","required":true,"description":"Date of the latest revenue or expense posting: the ledger is booked up to here; later months are not booked yet"},{"name":"company","type":null,"required":true,"description":null},{"name":"documents_to_process","type":"number|null","required":true,"description":"Uploaded documents in state unprocessed"},{"name":"errors","type":"array","required":true,"description":null},{"name":"incomplete","type":"array","required":true,"description":"Sections where UOL had more rows than one call reads; their figures may be too low"},{"name":"previous_month","type":null,"required":true,"description":null},{"name":"receivables","type":null,"required":true,"description":null},{"name":"this_month","type":null,"required":true,"description":null},{"name":"vat_current_period","type":null,"required":true,"description":"The running period, still open"},{"name":"vat_due_next","type":null,"required":true,"description":"The period whose return and payment are due next — what will be paid"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":98}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-05T14:03:18.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"none","label":"No attestation","reason":"no_attestation","reasonLabel":"No attestation published","discovery":null,"discoveryLabel":null,"sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":6,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-05","recent":[{"id":"chg_01a1ab74-c971-761e-a50f-5d5bcb551241","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp#chg-chg_01a1ab74-c971-761e-a50f-5d5bcb551241"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp","markdown":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp.md","changelogJson":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/eu-humblecode-uol/uol-mcp.xml","external":[{"label":"Repository","href":"https://github.com/jakubbegera/uol-mcp"}]}}