Kontor MCP server
io.github.DashankaNadeeshanDeSilva/kontor-mcp·v1.0.4Offline e-invoice tools for AI agents: validate, audit, convert and generate XRechnung/ZUGFeRD.
0 stars63 downloads/wk
Reviews
Write oneNobody has reviewed Kontor MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Kontor MCP tools (8, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
audit_invoiceOne-call audit for accounts payable: parse + validate (XSD, official EN 16931 / XRechnung rules, Kontor plausibility: totals recomputed, VAT rates, IBAN, Leitweg-ID check digits, dates, duplicates) and return header facts, VAT breakdown, verdict, grouped findings with fix hints and an accept / review / reject recommendation with rationale. Fully offline.
check_obligationsOffline decision tree over the German e-invoicing mandate (§ 14 / § 27 Abs. 38 UStG, UStDV §§ 33/34/34a, E-RechV): what applies to an issuer or receiver (B2B / B2G / B2C), from when, transition rules (2026, 2027 with the €800,000 prior-year turnover threshold, 2028), exemptions (small business, small-amount invoices, exempt supplies, cross-border), accepted formats and whether a Leitweg-ID is need
convert_invoiceConvert an invoice: extract the XML from a ZUGFeRD/Factur-X PDF, convert UBL ↔ CII via the EN 16931 semantic model (post-validated, with an honest loss report of anything that did not survive), or render a self-contained HTML preview to show the invoice to a human. Optional `output_path` writes the artifact (no overwrite unless `overwrite=true`). Fully offline.
explain_ruleExplain an EN 16931 / XRechnung rule id (e.g. BR-DE-15): official text, plain-language explanation (DE/EN), affected business terms, fix hint. Unknown ids get nearest-match suggestions.
generate_invoicewrite actionCreate a compliant e-invoice from structured data: XRechnung 3.0 (UBL 2.1, default) or a ZUGFeRD 2.3 / Factur-X PDF/A-3 with embedded factur-x.xml (`target: zugferd-pdf`, profiles EN16931 / BASIC / EXTENDED). Amounts, VAT breakdown and totals are derived decimal-safe; the result is validated internally — for PDFs the XML is read back out of the generated file first (fail-honest: `valid` reports th
list_capabilitiesIntrospect this server: supported formats and profiles, bundled standard versions (XRechnung, EN 16931, KoSIT configuration, XSDs), rule knowledge-base stats, code lists, legal parameters' last-verified date, tools/resources/prompts and the sovereignty statement (offline, no persistence).
parse_invoiceDetect the format (UBL/CII, EN 16931, XRechnung version, ZUGFeRD/Factur-X profile) of an XML or ZUGFeRD PDF invoice and return its EN 16931 semantic model (BT-annotated). Fully offline.
validate_invoiceValidate an XML or ZUGFeRD PDF invoice against XML Schema and the official EN 16931 / XRechnung Schematron rules (KoSIT-equivalent verdict) plus Kontor plausibility checks, with plain-language explanations and fix hints. Fully offline.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan39 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 65 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Kontor MCP compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 62% of 1,759 Finance servers
- Tools
- 8
- the typical Finance server has 8
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 63
- more than 55% of 422 Finance servers with a package
What its tools let an agent do: 7 read · 1 create
Install Kontor MCP in Claude Code, Cursor or VS Code
Runs npx -y @kontor-mcp/server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add kontor-mcp -- npx -y @kontor-mcp/server
What the publisher says
From the Kontor MCP repository's README, as published. We do not edit it. Read it on GitHub
Kontor MCP
The sovereign e-invoice toolkit for AI agents. Official XRechnung / EN 16931 validation, ZUGFeRD in and out, 100 % offline, zero API keys.
Kontor MCP is a local, offline toolbox that lets AI assistants (Claude Desktop, Claude Code, any MCP client) handle German/EU e-invoices: XRechnung and ZUGFeRD/Factur-X under EN 16931. It can read an invoice (bare XML or XML embedded in a PDF), check it against the official KoSIT / EN 16931 rulebooks, explain cryptic errors in German or English, create valid new invoices (XML or ZUGFeRD PDF/A-3), convert between formats, and tell a business which legal obligations apply. The key promise is sovereignty: no cloud, no API keys, no network calls, no Java at runtime — proven by tests.
Why it matters: since 2025 every German business must be able to receive e-invoices, and from 2027/2028 must issue them. An e-invoice is validated XML, not a PDF, and a failed rule can cost the input-VAT deduction. Invoices carry personal and bank data, so they should be checked where they live — on your machine — with the same rule sets the public-sector receivers use.
Claude Desktop with the kontor server: validate → BR-DE-15 (missing Leitweg-ID) with fix hint · parse a ZUGFeRD PDF · explain BR-DE-18. MP4
v1.0 — 8 tools · 4 resource families · 3 prompts · KoSIT conformance 89/89 enforced as a CI gate · ZUGFeRD PDF/A-3 output verified by veraPDF and Mustang · stdio and Streamable HTTP (bearer auth) · Docker image (amd64/arm64) · kontor-agent reference client · listed in the Official MCP Registry. Install with npx, Docker, or from source.
Why
- Official rules, not approximations. The KoSIT XRechnung Schematron and the CEN EN 16931 rules run unmodified (compiled to XSLT/SEF, executed with Saxon-JS) with the KoSIT scenario model — the same verdicts the public-sector receivers produce, proven file-by-file against the official validator.
- Sovereign by construction. Pure TypeScript/WASM, no Java at runtime, no network calls, nothing stored, nothing logged. Runs where the invoices are.
- Agent-native. Every tool returns structured content and a readable summary; findings carry DE/EN explanations, affected business terms and fix hints; generation is fail-honest (valid is the real verdict, never assumed).
- ZUGFeRD both ways. Read the embedded XML out of any ZUGFeRD/Factur-X PDF; write PDF/A-3 invoices with factur-x.xml that pass veraPDF and Mustang.
Five-minute quickstart
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Kontor MCP: common questions
- Is Kontor MCP server safe?
- Mostly: it is graded B (78/100). Read the Kontor MCP safety report
- How do I install Kontor MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Kontor MCP need an API key?
- Yes. The registry entry asks for
KONTOR_AUTH_TOKEN. - Is Kontor MCP maintained?
- The last commit was 70 days ago (2026-08-27). The latest release is v1.0.4.
- What can I use instead of Kontor MCP?
- Servers from other publishers that do the same job: ApexCharts MCP server, three.ws Tutor MCP server and SatGate – Economic Firewall for AI Agents MCP server.
- How does Kontor MCP compare with other Finance MCP servers?
- safety score 78/100 (higher than 62% of 1,759 Finance servers); tools 8 (the typical Finance server has 8); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Kontor MCP
Same job from other publishers: the closest match first, then the best rated.
- ApexChartsGenerates and validates configs for ApexCharts charts, grid, gantt, tree, sankey, stock and maps.not reviewedGrowingA
- three.ws TutorRead a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.not reviewedEstablishedA
- SatGate – Economic Firewall for AI AgentsBudget, payment and audit controls for AI agent API calls and MCP tool calls.not reviewedEstablishedA
- E ArveldajaEstonian e-arveldaja (RIK e-Financials) accounting — invoices, bank import, reports.not reviewedEstablishedB
- QuickbooksMCP server for QuickBooks Online (Intuit) — customers, invoices, payments, items, accounts, P&Lnot reviewedEstablishedB