{"id":"ch.zeno-works/zeno","slug":"ch-zeno-works-zeno","title":"Zeno","description":"AI bookkeeper for Swiss small companies: books invoices, reconciles the bank, keeps VAT current.","version":"0.1.0","publisher":{"kind":"domain","id":"zeno-works.ch","label":"zeno-works.ch","url":"https://zeno-works.ch"},"website":"https://zeno-works.ch","repository":"","remotes":[{"type":"streamable-http","url":"https://app.zeno-works.ch/mcp","headers":[{"description":"Zeno API key. Get one via the request_api_key tool or see https://zeno-works.ch/skill.md","isSecret":true,"name":"X-API-Key"}]}],"packages":[],"published":"2026-10-11","updated":"2026-10-11","status":"online","auth":"","latency_ms":1322,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"find_operations","title":"","description":"Search EVERY operation this server offers, including the ones not in your tool list.\n\nThe tool list you can see holds only the common operations. Several hundred\nmore — payroll, VAT returns, year-end close, fixed assets, expenses, cash\nbook, settings, integrations, onboarding — are available but unlisted, and\nthis is how you find them. **Search here before concluding that Zeno cannot\ndo something.","read_only":false},{"name":"describe_operations","title":"","description":"Get the full argument schema for operations found via ``find_operations``.\n\nReturns each operation's description and JSON-Schema arguments — everything\na listed tool would have shown you.\n\n``include_output_schema`` is the ONLY way to obtain an operation's result\nshape: ``tools/list`` publishes no output schema for any operation, listed or\nnot (they are 67 % of the payload, and a schema describing ","read_only":false},{"name":"call_operation","title":"","description":"Run any operation by name — the ones in your tool list and the unlisted ones alike.\n\n``name`` is an operation name from ``find_operations``; ``arguments`` is the\nobject described by ``describe_operations`` (omit it for an operation that\ntakes none). The result, and any error, are exactly what calling the\noperation directly would give you.","read_only":false},{"name":"request_api_key","title":"","description":"Ask the user to hand this session a Zeno API key. **Use this first** — every\ncurrent Zeno user already has an account.\n\n`email` is the address on their Zeno account. **Ask them for it**; you cannot\nguess it, and the request is aimed by it — Zeno will only show it to somebody\nsigned in as the owner of that address. Pass `client_name` too: it is the only\nthing identifying you on the approval page, a","read_only":false},{"name":"start_signup","title":"","description":"Create a Zeno account for somebody who does not have one yet.\n\nUse `request_api_key` first if they might already have an account — this tool\ncannot tell you, and deliberately never will.\n\nWe email `email` a verification link. The user opens it, sees that you asked\n(by the name in `client_name`, shown as an unverified claim), chooses their own\npassword, and decides separately whether to connect you","read_only":false},{"name":"collect_api_key","title":"","description":"Collect the key once the user has approved.\n\n`status` is one of:\n\n- `pending` — nobody has approved yet, or (with `throttled: true`) we were\n  rate-limited and learned nothing. **Wait `poll_interval_seconds`, then call\n  again** — every answer carries it. Do not ask the user to tell you when they\n  are done: you cannot detect it any other way, and handing the wait back to the\n  user is how these s","read_only":false},{"name":"whoami","title":"","description":"Which user this request acts as, and which company's books it is bound to (jwt or API key).\n\nZeno serves every tenant from one host, and an API key is opaque — nothing else\ntells a connected agent whose books it is about to write. Call this FIRST when\nworking over MCP: ``company_scoped: true`` means this connection's data access\nis confined to ``company_id`` — ``company_name`` names it (null here ","read_only":false},{"name":"list_companies","title":"","description":"List companies (jwt, scoped). Non-admins see only their member companies.","read_only":false},{"name":"get_company","title":"","description":"Get one company (jwt, scoped). 403 for a non-member non-admin, 404 if absent.","read_only":false},{"name":"global_search","title":"","description":"Full-text search across emails + items, ranked by ``ts_rank_cd``, scoped (A1).\n\n``archive_status`` constrains item results only (the Documents → Archive page\npasses ``archived`` so its search box never surfaces pending/triage-parked items).","read_only":false},{"name":"process_status","title":"","description":"Is this company done, and what next (ZEN-2). Start and end here.\n\n``done``: no held AI proposal, no unmatched or partly matched bank movement, Suspense\nexplained, no unreadable, waiting, unreviewed or rejected-unbooked document (``null`` when\nit cannot be checked). Lists every open item; work them through ``book_documents_act`` or\n``reconcile_bank_act`` as each row's ``process`` says. Read-only.","read_only":false},{"name":"book_documents_act","title":"","description":"One action on one open document (ZEN-2): an action its row offers, with its ``version``.\n\n``accept`` posts the held proposal; ``reject`` closes it unposted (a person books the\ndocument); ``keep``, ``reanalyze``, ``mark_irrelevant``, ``delete``; ``skip`` / ``unskip``\nleave it to a person. All but accept and unskip need a ``reason``. Recorded with your user;\nan agent decides a hold only where the ow","read_only":false},{"name":"reconcile_bank_act","title":"","description":"One action on one open bank movement (ZEN-2), with its row's ``version``: ``accept`` its\nheld proposal, ``ignore`` it, ``skip`` / ``unskip``. Ignore and skip need a ``reason``;\nrecorded with your user. Link and settle through the row's ``operations``. Returns the new\nstatus.\n\nOn this MCP surface a `null` argument means \"not provided\": it is dropped before the request is sent, exactly as if the fie","read_only":false},{"name":"accept_autopost_decision","title":"","description":"One-click accept of a **held** decision (accountant) — posts the AI's proposal.\n\nA person's accept overrides the soft guardrails. An agent's is refused (403) unless\nthe row is ``agent_acceptable`` or an expense receipt. Closed period, sealed year,\nunknown account: 409/422. The row flips ``held → posted`` (again: 409);\n``accepted_by_kind`` records the channel (``mcp`` over MCP).\n\nOptional ``body``:","read_only":false},{"name":"upload_intake","title":"","description":"Upload ANY file; the system decides what it is (the unified intake queue,\nthe web app's Documents > Upload). ``file_base64``: raw bytes, base64.\n\nPrefer this unless plainly an invoice; always for bank statements (CAMT.053\nXML, PDF, CSV or .xlsx; not legacy .xls), matched to the registered bank account\nby IBAN; journal/accounting exports; balance sheets, P&L and VAT filings. A\nmixed .zip is routed ","read_only":false},{"name":"upload_document","title":"","description":"Upload an INVOICE or RECEIPT (PDF, image, or .zip of them) for analysis.\n``file_base64`` is the file's raw bytes, base64-encoded. ``direction`` is\n``payable`` (incoming supplier invoice) or ``receivable`` (outgoing).\nCreates Item(s) and queues extraction.\n\nThis door is invoices-only: it never routes a file onward by type, so a\nbank statement, a journal export or a balance sheet sent here is analys","read_only":false},{"name":"get_intake","title":"","description":"Get one intake row by id (scoped to its company: 404/403 split).","read_only":false},{"name":"list_items","title":"","description":"List/filter items, scoped to the caller's member companies (A1).\n\nOptional ``period`` (``YYYY-MM``) filters by the item's effective date\n(invoice date, falling back to the Europe/Zurich-local ingestion date); a\nmalformed value returns 422 ``{\"msg\": \"period must be YYYY-MM\"}``.\n``exclude_triage_status`` drops items carrying that triage verdict (NULL-safe;\nfor ``unrelated`` not a booked one, ZCT-954","read_only":false},{"name":"get_item","title":"","description":"Item metadata (any source).","read_only":false},{"name":"upload_bank_statement","title":"","description":"Import a BANK STATEMENT. CAMT.053 XML books at once; PDF, CSV, .xlsx queue\n(``list_bank_statement_imports``); .zip splits; legacy .xls, UTF-16 CSV refused.\nCSV/.xlsx imports only if opening + lines = closing, else nothing; with no\nprinted opening/closing balance it fails until the person's balances per\n``balances_needed`` (and the account if no IBAN) come via\n``assign_bank_statement_import_account","read_only":false},{"name":"upload_accounting_import","title":"","description":"Import a JOURNAL EXPORT (CSV/Excel) from another accounting system\n(``source_system``, e.g. bexio, abacus) and match it against the bank entries.\n``file_base64`` is the file's raw bytes, base64.","read_only":false},{"name":"upload_accounting_document","title":"","description":"Upload a company's BALANCE SHEET, P&L or VAT return (PDF, PNG, JPEG, XLSX)\nto be read; queued, follow ``get_accounting_document``. ``fiscal_year`` when the\nfile does not say; ``force`` re-reads a file already read.\n``file_base64`` is the file's raw bytes, base64.","read_only":false},{"name":"attach_cash_entry_receipt","title":"","description":"Attach a receipt to a posted cash-book entry: a new file (``file_base64``,\nthe raw bytes, base64) OR an existing document's ``item_id``, exactly one.\n``override_duplicate`` only after a duplicate refusal you checked.","read_only":false},{"name":"attach_claim_receipt","title":"","description":"Attach a receipt to an expense-claim line: a new file (``file_base64``, the\nraw bytes, base64) OR an existing document's ``item_id``, exactly one; repeat\nthat ``item_id`` as ``receipt_from_upload`` when ``ingest_expense_receipt``\nreturned it. ``override_duplicate`` only after a duplicate refusal you checked.","read_only":false},{"name":"ingest_expense_receipt","title":"","description":"Upload ONE expense receipt to put on a claim: it is held from automatic\nbooking; poll ``get_expense_receipt``, then attach its ``item_id`` with\n``attach_claim_receipt``. ``file_base64`` is the file's raw bytes, base64.","read_only":false},{"name":"import_payroll_employees","title":"","description":"Import employees from the filled-in template\n(``get_payroll_employee_import_template``, .xlsx/.csv). All or nothing;\nexisting ``employee_no`` rows are skipped. ``dry_run`` only reports.\n``file_base64`` is the file's raw bytes, base64.","read_only":false},{"name":"gl_trial_balance","title":"","description":"Per-account debit/credit columns for one fiscal year, with totals.\n\n``fiscal_year`` (year label) defaults to the latest year posted in; ``period_id``\nnarrows to one period of it. No all-years mode — account identity is\n``(company, fiscal year, code)``, so aggregating double-counts silently (ZET-155).\nUnknown year/period → 404; period outside the year → 422.\n\nCut by the line's stamped ``fiscal_year","read_only":false},{"name":"list_gl_accounts","title":"","description":"List the postable chart (CompanyMember). ``fiscal_year`` filters to one year's chart\n(the chart is FY-scoped, so codes repeat across years).","read_only":false},{"name":"get_gl_account_ledger","title":"","description":"One account's ledger (Kontoauszug) — every booking that touched it, in date\norder, with Soll/Haben and the running balance after each line (CompanyMember).\n\nNo fiscal-year parameter: the chart is FY-owned, so ``account_id`` already\nfixes the year. Posted **and** reversed entries are included (a reversal is a\nsecond posted entry, so both legs must show or the balance is wrong); drafts\nare not. The ","read_only":false},{"name":"list_gl_periods","title":"","description":"The company's **accounting periods** — the months a journal entry may post into\n(CompanyMember read).\n\nA period belongs to one fiscal year and carries ``period_no`` (1..12 within the\nyear), ``date_from``/``date_to`` and a ``status``: ``open`` accepts postings,\n``soft_closed`` still accepts them, and ``closed``/``year_closed`` refuse them — a\nposting date inside a closed period fails until an accou","read_only":false},{"name":"list_gl_open_items","title":"","description":"One page of the AR/AP subledger (member read).\n\n``direction`` filters server-side (ZCT-577); omit it for both.\n``commercial_document_id`` narrows to one document's item (D09-G13); not with ``as_of``.\n\n``as_of`` (ZCT-577) reconstructs each item's open amount from posted journal lines\ndated on or before that date, instead of reading today's cached amount. Items are\nconsidered **regardless of their c","read_only":false},{"name":"list_gl_journal_entries","title":"","description":"List journal entries.\n\n``period_ids`` narrows to specific fiscal periods, and is how a caller asks for\n**one fiscal year**: the year's period ids (ZET-285). Without it the route lists every\nfiscal year. ``total`` is the filtered total.\n\n``untagged_subledger_control=true`` narrows to the entries that posted to an\nAR/AP control account **without** touching the subledger, under\n``allow_untagged_contr","read_only":false},{"name":"get_gl_journal_entry","title":"","description":"One entry + lines, plus the subledger rows it produced/touched (Gap B detail\nsurfacing): its ``gl_vat_posting`` rows, its ``gl_vat_zero_posting`` turnover-only\ndeclarations (zero-rated/exempt output — R2-13b: these have no VAT line to pair, so\nwithout them a correctly coded 0 % line is indistinguishable from an untagged one)\nand referenced ``gl_open_item`` rows. A declared base line also carries t","read_only":false},{"name":"create_gl_journal_entry","title":"","description":"Create a **draft** journal entry by hand — accountant. It carries NO source document\nunless you name one.\n\nOnly the pipeline paths stamp ``source_ref_type``/``source_ref_id`` (an ingested\ndocument is ``'item'``), so by default a booking made here cannot be traced back to\nwhat justified it. ``document_id`` is the retrofit: name an existing ``gl_document``\n(create one with ``POST …/gl/documents``) a","read_only":false},{"name":"post_gl_journal_entry","title":"","description":"Post a draft entry into the books — accountant. One-way.\n\nA posted entry can no longer be replaced or discarded (both refuse with 409); the only\ngeneral correction is ``…/reverse``, which leaves both the original and the reversal\nvisible. The one exception is ``PUT …/guessed-account``, which re-points a\n``coding_guessed`` entry's expense account in place — and it works *only* on a posted\nentry. Ch","read_only":false},{"name":"reverse_gl_journal_entry","title":"","description":"**Storno** a posted journal entry: post its mirror image (accountant role).\n\nNothing is deleted; the original stays, linked, and the **reversal** entry is returned.\nThe only VAT-correct storno door — VAT postings, open items and what the document\nspawned are all unwound.\n\n``body.posting_date`` dates the reversal and decides its period; omitted, it reuses\nthe original's. A closed-period entry needs","read_only":false},{"name":"list_bank_accounts","title":"","description":"The company's bank accounts — the ``bank_account_id`` every statement import,\nbank-entry list and reconciliation call needs (CompanyMember read).\n\nOldest first, no filter and no paging. Each row carries the ``iban``, ``currency``,\n``label``/``bank_name`` and ``ledger_account_number`` — the chart code this account\nposts through; **without one a bank movement cannot be coded**, and it is set with\n``","read_only":false},{"name":"list_bank_entries","title":"","description":"Bank movements (statement lines), latest first.","read_only":false},{"name":"get_bank_entry","title":"","description":"One bank movement with its reconciliation state and links.","read_only":false},{"name":"entry_candidates","title":"","description":"Documents, booked invoices, open items one movement may pay; link one, then settle_entry.","read_only":false},{"name":"settle_entry","title":"","description":"Post this reconciled bank entry into the GL (clean-bank settlement).\n\nMatched → Dr Bank / Cr AR; unmatched → Dr Bank / Cr Suspense; a previously-suspensed\nentry now fully matched → Dr Suspense / Cr AR. Idempotent; ``skipped`` when the GL chart\nis not configured for native settlement.\n\n**Skonto (ZEN-526).** ``cash_discounts`` names, per open item this movement pays, the cash\ndiscount the counterpar","read_only":false},{"name":"list_ar_invoices","title":"","description":"List authored AR invoices, newest first.\n\nOptional ``status`` / ``doc_type`` filter by lifecycle + document kind.\nOptional ``period`` (``YYYY-MM``) filters by the invoice's issue date (its\nmonth); a malformed value returns 422 ``{\"msg\": \"period must be YYYY-MM\"}``.","read_only":false},{"name":"get_ar_invoice","title":"","description":"One authored outgoing invoice with its lines (CompanyMember read).\n\nCarries the header (customer, dates, currency, discounts), every line with its\ncomputed ``net_amount``/``vat_amount``/``gross_amount``, the document totals, and\nthe lifecycle: ``status`` (``draft`` → ``issued`` → ``cancelled``), ``document_no``\n(assigned at issue — ``null`` on a draft), ``commercial_document_id`` /\n``snapshot_docu","read_only":false},{"name":"list_counterparties","title":"","description":"List a company's counterparties (filter by ``kind``/``q``, paginated).\n\n``kind`` repeats to filter on a set (``?kind=customer&kind=both``) — a\nrole-shaped picker asks for every kind that plays the role. A single\n``?kind=supplier`` keeps its original meaning.","read_only":false},{"name":"list_gl_vat_periods","title":"","description":"VAT return periods with status, filing and payment state, and the due windows.","read_only":false},{"name":"get_financial_statements","title":"","description":"Computed balance sheet + P&L for a fiscal year, from the journal (CompanyMember).\n\nAggregates every posted GL journal line whose **posting date** falls in the fiscal\nyear's window, classifies each account against the chart of accounts, and reports\nproblems (unbalanced trial balance, unclassified accounts, year-not-opened, mixed\ncurrency). **Read-only and distinct** from the uploaded balance-sheet ","read_only":false},{"name":"customer_statement","title":"","description":"One customer's open items + totals (the aging row's drill-down).\n\n``as_of`` mirrors ``GET …/ar/aging`` — set, it reconstructs the items open at\nthat date so the statement agrees with a historical aging report.","read_only":false},{"name":"get_bank_status","title":"","description":"Composed bank snapshot — \"is my banking up to date?\" (CompanyMember). \"Reconciled\" means\nentries matched, NOT ledger = statement balance (the close check\n``BANK_BALANCE_DOES_NOT_TIE_OUT`` compares that).\n\nPer-account entry-status and ``in_suspense`` counts, each account's latest closing\nbalance, and the **company-level cumulative GL Suspense balance**. Non-zero suspense\nblocks a clean VAT close.\n\n","read_only":false},{"name":"zeno_info","title":"","description":"What this server is, which MCP revision it speaks, and how to get a credential.\n\n**Needs no credential.** Call it first if a tool has just refused you: the\n`authentication` block names the tools that can get this session connected.","read_only":false},{"name":"zeno_overview","title":"","description":"What Zeno does, in one page — the platform's capabilities and its limits.\n\n**Needs no credential.** Read this before telling a user that Zeno cannot do\nsomething; it covers VAT, payroll, reconciliation and the AI accountant.","read_only":false},{"name":"onboarding_guide","title":"","description":"How to onboard and create a NEW company: what to ask the user for, which\ndocuments to request, and the order to run the setup in.\n\nDiscovery does not depend on search: this tool is in the tier, so it is listed for\nevery caller, and `BASE_INSTRUCTIONS` names it. `find_operations` does reach it\n(\"new company setup\" ranks it first), but a query made only of common words is\nstill decided by whichever ","read_only":false}],"server_info":{"name":"zeno","version":"0.1.0+466b054234"},"category":"finance","tags":["hr","productivity","support"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-11","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ch-zeno-works-zeno/"}