@lekteo/mcp 0.1.2

package/LICENSE

@@ -0,0 +1,58 @@
+Lekteo MCP — licence
+
+Ce paquet réunit deux choses aux conditions différentes. La distinction est
+volontaire et tient en une phrase : l'enveloppe est ouverte, le moteur ne
+l'est pas.
+
+
+1. L'ENVELOPPE — répertoire `src/`
+
+Le serveur MCP lui-même, publié sous licence Apache 2.0.
+
+    Copyright 2026 Lekteo
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied. See the License for the specific language governing
+    permissions and limitations under the License.
+
+C'est le code que vous êtes invité à lire avant de pointer ce serveur sur vos
+factures. Il est livré avec le paquet pour cette raison précise.
+
+
+2. LE MOTEUR DE LECTURE — compilé dans `dist/server.js`
+
+La détection de format, la lecture UBL / CII / Factur-X, le modèle canonique
+et les contrôles EN 16931 restent la propriété de l'éditeur de Lekteo.
+
+Vous êtes autorisé, sans frais et sans démarche :
+
+  · à utiliser ce paquet, y compris à titre professionnel et commercial,
+    sans limite de volume ni de durée ;
+  · à le redistribuer tel quel, sans modification ;
+  · à l'intégrer dans vos propres outils et flux de travail.
+
+Vous n'êtes pas autorisé :
+
+  · à redistribuer une version modifiée du moteur ;
+  · à en extraire le code pour le publier ou le proposer séparément.
+
+La décompilation à des fins d'interopérabilité reste permise dans les limites
+prévues par le droit applicable, notamment l'article L122-6-1 du code de la
+propriété intellectuelle et la directive 2009/24/CE.
+
+
+3. GARANTIE
+
+Ce logiciel est fourni « en l'état », sans garantie d'aucune sorte. Il lit des
+factures et signale des écarts avec une norme ; il ne constitue ni un conseil
+comptable, ni un conseil fiscal, ni un conseil juridique. Un document déclaré
+conforme reste soumis à l'appréciation de votre comptable et de
+l'administration.

package/README.de.md

@@ -0,0 +1,103 @@
+# @lekteo/mcp
+
+[English](https://lekteo.eu/en/mcp) · [Français](https://lekteo.eu/mcp) · **Deutsch** · [Nederlands](https://lekteo.eu/nl/mcp)
+
+**Lesen Sie Ihre elektronischen Rechnungen aus Ihrem Assistenten, ohne dass sie Ihren Rechner verlassen.**
+
+UBL 2.1, CII D22B, Factur-X, ZUGFeRD, XRechnung, Peppol BIS. Die Datei wird von
+Ihrer Platte gelesen, in Ihrem Prozess verarbeitet, und nichts wird irgendwohin
+übertragen.
+
+## Installation
+
+Nichts zu installieren im eigentlichen Sinn: der Befehl holt den Server bei
+Bedarf.
+
+**Claude Code**
+
+```bash
+claude mcp add lekteo -- npx -y @lekteo/mcp
+```
+
+**Claude Desktop** — in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lekteo": { "command": "npx", "args": ["-y", "@lekteo/mcp"] }
+  }
+}
+```
+
+**Andere MCP-Clients**: Befehl `npx`, Argumente `["-y", "@lekteo/mcp"]`,
+stdio-Transport. Node 20 oder neuer.
+
+## Was Sie damit bekommen
+
+| Werkzeug          | Was es tut                                                                        |
+| ----------------- | --------------------------------------------------------------------------------- |
+| `read_invoice`    | Öffnet die Rechnung: Parteien, Positionen, Steueraufteilung, Summen, Zahlung      |
+| `check_invoice`   | Beantwortet „ist sie in Ordnung?“ – EN-16931-Prüfungen, ohne den Inhalt zu zeigen |
+| `invoice_to_json` | Das vollständige kanonische Modell, für ein Skript oder eine Tabelle              |
+
+Die Hinweise erscheinen auf **Deutsch, Französisch, Englisch oder
+Niederländisch** – Parameter `locale`.
+
+Anfragen, die unmittelbar funktionieren:
+
+- „Öffne `~/rechnungen/F2026-114.xml` und nenne mir den Zahlbetrag“
+- „Ist diese Rechnung konform?“
+- „Prüfe alle Rechnungen in diesem Ordner und nenne die fehlerhaften“
+
+## Was geprüft wird
+
+Die `BR-xx`-Regeln der europäischen Norm EN 16931, dazu eigene Prüfungen:
+Prüfziffer der IBAN, Aufbau der Unternehmens- und Umsatzsteuer-Identifikations­
+nummern, jeder Steuerbetrag gegen seine Bemessungsgrundlage, und das
+Rechnungsdatum vor dem Fälligkeitsdatum.
+
+Eine XML-Datei kann formal einwandfrei und trotzdem falsch sein. XML garantiert
+die Struktur, nicht die Richtigkeit.
+
+## Nichts verlässt Ihren Rechner
+
+Dieser Server führt **keinen Netzwerkzugriff** aus. Kein HTTP-Client, keine
+Telemetrie, keine Update-Prüfung. Sie müssen uns nicht glauben:
+
+```bash
+grep -c "fetch(\|XMLHttpRequest\|node:http" "$(npm root -g)/@lekteo/mcp/dist/server.js"
+```
+
+Der Build **schlägt fehl**, wenn eine dieser Zeichenketten im Bundle auftaucht.
+Das ist eine Prüfung im Build, keine erklärte Absicht.
+
+Der Quelltext der Hülle liegt in `src/` bei, unter Apache 2.0, damit Sie ihn
+lesen können, bevor Sie ihn auf Ihre Rechnungen richten. Die Lese-Engine ist in
+`dist/` kompiliert und bleibt proprietär, frei nutzbar und unverändert frei
+weitergebbar. Die vollständigen Bedingungen stehen in der Datei `LICENSE`, die dem Paket beiliegt.
+
+## Warum er lokal läuft
+
+[lekteo.eu](https://lekteo.eu/de) liest Rechnungen im Browser, und jeder kann
+im Netzwerk-Tab nachprüfen, dass nichts seinen Rechner verlässt. Ein Assistent
+öffnet keinen Tab. Dieselbe Funktion von einem entfernten Server anzubieten
+hätte bedeutet, Ihre Rechnungen zu uns hochzuladen – genau das, was dieses
+Produkt vermeiden soll.
+
+Also läuft er bei Ihnen. Das Versprechen bleibt nicht nur erhalten, es
+erweitert sich: es gilt nun auch außerhalb des Browsers.
+
+## Die Web-Version
+
+**[lekteo.eu](https://lekteo.eu/de)** – dieselbe Engine, im Browser, ohne
+Installation. Nützlich, wenn Sie einfach eine Rechnung ansehen oder einen
+ganzen Ordner mit exportierbarer Übersicht verarbeiten wollen.
+
+Die [MCP-Seite](https://lekteo.eu/de/mcp) greift dieselben Punkte auf, in vier
+Sprachen.
+
+## Unterstützen
+
+Dieser Server ist kostenlos und bleibt es. Wenn er Ihnen bei der Arbeit Zeit
+spart, finden Sie auf [lekteo.eu](https://lekteo.eu/de) einen Link zur
+Unterstützung – in den Antworten des Werkzeugs wird es nie einen geben.

package/README.fr.md

@@ -0,0 +1,102 @@
+# @lekteo/mcp
+
+[English](https://lekteo.eu/en/mcp) · **Français** · [Deutsch](https://lekteo.eu/de/mcp) · [Nederlands](https://lekteo.eu/nl/mcp)
+
+**Lisez vos factures électroniques depuis votre assistant, sans qu'elles quittent votre machine.**
+
+UBL 2.1, CII D22B, Factur-X, ZUGFeRD, XRechnung, Peppol BIS. Le fichier est lu
+sur votre disque, analysé dans votre processus, et rien n'est transmis nulle
+part.
+
+## Installation
+
+Rien à installer à proprement parler : la commande télécharge le serveur à la
+demande.
+
+**Claude Code**
+
+```bash
+claude mcp add lekteo -- npx -y @lekteo/mcp
+```
+
+**Claude Desktop** — dans `claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "lekteo": { "command": "npx", "args": ["-y", "@lekteo/mcp"] }
+  }
+}
+```
+
+**Autres clients MCP** : commande `npx`, arguments `["-y", "@lekteo/mcp"]`,
+transport stdio. Node 20 ou plus.
+
+## Ce que ça vous donne
+
+| Outil             | Ce qu'il fait                                                                   |
+| ----------------- | ------------------------------------------------------------------------------- |
+| `read_invoice`    | Ouvre la facture : parties, lignes, ventilation de TVA, totaux, règlement       |
+| `check_invoice`   | Répond à « est-elle en règle ? » — contrôles EN 16931, sans afficher le contenu |
+| `invoice_to_json` | Le modèle canonique complet, pour un script ou un tableur                       |
+
+Les constats sont rendus en **français, anglais, allemand ou néerlandais** —
+paramètre `locale`.
+
+Des demandes qui fonctionnent telles quelles :
+
+- « Ouvre `~/factures/F2026-114.xml` et dis-moi le net à payer »
+- « Cette facture est-elle conforme ? »
+- « Vérifie toutes les factures de ce dossier et liste celles qui posent problème »
+
+## Ce qui est contrôlé
+
+Les règles `BR-xx` de la norme européenne EN 16931, plus des vérifications
+propres : clé de contrôle des IBAN, structure du SIREN et des numéros de TVA,
+cohérence entre chaque montant de TVA et sa base imposable, antériorité de la
+date d'émission sur l'échéance.
+
+Un fichier XML peut être parfaitement bien formé et pourtant faux. Le XML
+garantit la structure, pas la justesse.
+
+## Rien ne sort de votre machine
+
+Ce serveur n'effectue **aucun accès réseau**. Pas de client HTTP, pas de
+télémétrie, pas de vérification de mise à jour. Vous n'avez pas à nous croire :
+
+```bash
+grep -c "fetch(\|XMLHttpRequest\|node:http" "$(npm root -g)/@lekteo/mcp/dist/server.js"
+```
+
+La compilation **échoue** si l'une de ces chaînes apparaît dans le bundle.
+C'est un contrôle du build, pas une intention affichée.
+
+Le code de l'enveloppe est livré dans `src/`, sous Apache 2.0, pour que vous
+puissiez le lire avant de le pointer sur vos factures. Le moteur de lecture est
+compilé dans `dist/` et reste propriétaire, d'usage et de redistribution
+libres. Les conditions complètes sont dans le fichier `LICENSE`, livré avec le paquet.
+
+## Pourquoi il tourne en local
+
+[lekteo.eu](https://lekteo.eu) lit les factures dans le navigateur, et
+n'importe qui peut vérifier que rien ne quitte sa machine en ouvrant l'onglet
+réseau. Un assistant n'ouvre pas d'onglet. Servir la même fonction depuis un
+serveur distant aurait voulu dire téléverser vos factures chez nous, ce que ce
+produit existe précisément pour éviter.
+
+Donc ça tourne chez vous. La promesse n'est pas seulement préservée, elle
+s'élargit : elle vaut désormais aussi hors du navigateur.
+
+## La version web
+
+**[lekteo.eu](https://lekteo.eu)** — même moteur, dans le navigateur, sans
+installation. Utile quand vous voulez juste voir une facture, ou traiter un
+dossier entier avec un récapitulatif exportable.
+
+La [page MCP](https://lekteo.eu/mcp) reprend ce fichier, en quatre langues.
+
+## Soutenir
+
+Ce serveur est gratuit et le restera. S'il vous fait gagner du temps au
+travail, il y a un lien de soutien sur [lekteo.eu](https://lekteo.eu) — il n'y
+en aura jamais dans les réponses de l'outil.

package/README.md

@@ -0,0 +1,100 @@
+# @lekteo/mcp
+
+**English** · [Français](https://lekteo.eu/mcp) · [Deutsch](https://lekteo.eu/de/mcp) · [Nederlands](https://lekteo.eu/nl/mcp)
+
+**Read your electronic invoices from your assistant, without them leaving your machine.**
+
+UBL 2.1, CII D22B, Factur-X, ZUGFeRD, XRechnung, Peppol BIS. The file is read
+from your disk, parsed in your process, and nothing is transmitted anywhere.
+
+## Install
+
+Nothing to install as such: the command fetches the server on demand.
+
+**Claude Code**
+
+```bash
+claude mcp add lekteo -- npx -y @lekteo/mcp
+```
+
+**Claude Desktop** — in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lekteo": { "command": "npx", "args": ["-y", "@lekteo/mcp"] }
+  }
+}
+```
+
+**Other MCP clients**: command `npx`, arguments `["-y", "@lekteo/mcp"]`, stdio
+transport. Node 20 or later.
+
+## What it gives you
+
+| Tool              | What it does                                                               |
+| ----------------- | -------------------------------------------------------------------------- |
+| `read_invoice`    | Opens the invoice: parties, lines, VAT breakdown, totals, payment          |
+| `check_invoice`   | Answers "is this in order?" — EN 16931 checks, without showing the content |
+| `invoice_to_json` | The full canonical model, for a script or a spreadsheet                    |
+
+Findings are rendered in **English, French, German or Dutch** — the `locale`
+parameter, French by default.
+
+Requests that work as they stand:
+
+- "Open `~/invoices/F2026-114.xml` and tell me the amount due"
+- "Is this invoice compliant?"
+- "Check every invoice in this folder and list the ones with a problem"
+
+## What is checked
+
+The `BR-xx` rules of the European EN 16931 standard, plus checks of our own:
+IBAN check digits, structure of company and VAT numbers, each VAT amount
+against its taxable base, and the issue date preceding the due date.
+
+An XML file can be perfectly well-formed and still wrong. XML guarantees
+structure, not correctness.
+
+## Nothing leaves your machine
+
+This server performs **no network access**. No HTTP client, no telemetry, no
+update check. You do not have to take our word for it:
+
+```bash
+grep -c "fetch(\|XMLHttpRequest\|node:http" "$(npm root -g)/@lekteo/mcp/dist/server.js"
+```
+
+The build **fails** if any of those strings appears in the bundle. It is a
+check in the build, not a stated intention.
+
+The wrapper source ships in `src/`, under Apache 2.0, so you can read it
+before pointing it at your invoices. The reading engine is compiled into
+`dist/` and stays proprietary, free to use and to redistribute unmodified.
+The full terms are in the `LICENSE` file, shipped with the package.
+
+## Why it runs locally
+
+[lekteo.eu](https://lekteo.eu/en) reads invoices inside the browser, and
+anyone can verify that nothing leaves their machine by opening the network
+tab. An assistant does not open a tab. Serving the same feature from a remote
+endpoint would have meant uploading your invoices to us — precisely what this
+product exists to avoid.
+
+So it runs on your machine. The promise is not merely preserved, it widens: it
+now holds outside the browser too.
+
+## The web version
+
+**[lekteo.eu](https://lekteo.eu/en)** — same engine, in the browser, with no
+installation. Useful when you simply want to look at an invoice, or run a
+whole folder with an exportable summary.
+
+The [MCP page](https://lekteo.eu/en/mcp) covers the same ground as this file,
+in four languages.
+
+## Support
+
+This server is free and will stay free. If it saves you time at work, there is
+a support link on [lekteo.eu](https://lekteo.eu/en) — there will never be one
+in the tool's answers.

package/README.nl.md

@@ -0,0 +1,102 @@
+# @lekteo/mcp
+
+[English](https://lekteo.eu/en/mcp) · [Français](https://lekteo.eu/mcp) · [Deutsch](https://lekteo.eu/de/mcp) · **Nederlands**
+
+**Lees uw elektronische facturen vanuit uw assistent, zonder dat ze uw toestel verlaten.**
+
+UBL 2.1, CII D22B, Factur-X, ZUGFeRD, XRechnung, Peppol BIS. Het bestand wordt
+van uw schijf gelezen, in uw proces verwerkt, en er wordt niets ergens naartoe
+gestuurd.
+
+## Installatie
+
+Er valt eigenlijk niets te installeren: het commando haalt de server op
+wanneer nodig.
+
+**Claude Code**
+
+```bash
+claude mcp add lekteo -- npx -y @lekteo/mcp
+```
+
+**Claude Desktop** — in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lekteo": { "command": "npx", "args": ["-y", "@lekteo/mcp"] }
+  }
+}
+```
+
+**Andere MCP-clients**: commando `npx`, argumenten `["-y", "@lekteo/mcp"]`,
+transport stdio. Node 20 of nieuwer.
+
+## Wat het u oplevert
+
+| Hulpmiddel        | Wat het doet                                                                     |
+| ----------------- | -------------------------------------------------------------------------------- |
+| `read_invoice`    | Opent de factuur: partijen, regels, btw-uitsplitsing, totalen, betaling          |
+| `check_invoice`   | Beantwoordt “is zij in orde?” — controles op EN 16931, zonder de inhoud te tonen |
+| `invoice_to_json` | Het volledige kanonieke model, voor een script of een rekenblad                  |
+
+De vaststellingen verschijnen in het **Nederlands, Frans, Engels of Duits** —
+parameter `locale`.
+
+Vragen die meteen werken:
+
+- “Open `~/facturen/F2026-114.xml` en zeg me het te betalen bedrag”
+- “Is deze factuur conform?”
+- “Controleer alle facturen in deze map en noem de foutieve”
+
+## Wat er wordt gecontroleerd
+
+De `BR-xx`-regels van de Europese norm EN 16931, plus eigen nazichten: het
+controlegetal van de IBAN, de opbouw van ondernemings- en btw-nummers, elk
+btw-bedrag tegen zijn maatstaf van heffing, en de factuurdatum vóór de
+vervaldatum.
+
+Een XML-bestand kan perfect gevormd zijn en toch fout. De XML waarborgt de
+structuur, niet de juistheid.
+
+## Niets verlaat uw toestel
+
+Deze server voert **geen enkele netwerktoegang** uit. Geen HTTP-client, geen
+telemetrie, geen controle op updates. U hoeft ons niet te geloven:
+
+```bash
+grep -c "fetch(\|XMLHttpRequest\|node:http" "$(npm root -g)/@lekteo/mcp/dist/server.js"
+```
+
+De build **mislukt** als een van die tekenreeksen in het bundel opduikt. Dat is
+een controle in de build, geen verklaarde bedoeling.
+
+De broncode van de omhulling zit in `src/`, onder Apache 2.0, zodat u hem kunt
+lezen voordat u hem op uw facturen richt. De leesmotor is gecompileerd in
+`dist/` en blijft eigendom van de uitgever, vrij in gebruik en ongewijzigd vrij
+te verspreiden. De volledige voorwaarden staan in het bestand `LICENSE`, dat met het pakket wordt meegeleverd.
+
+## Waarom hij lokaal draait
+
+[lekteo.eu](https://lekteo.eu/nl) leest facturen in de browser, en iedereen kan
+in het netwerktabblad nakijken dat er niets zijn toestel verlaat. Een assistent
+opent geen tabblad. Dezelfde functie vanaf een server aanbieden zou betekenen
+dat uw facturen naar ons worden geüpload, precies wat dit product wil
+vermijden.
+
+Dus draait hij bij u. De belofte blijft niet alleen overeind, zij wordt ruimer:
+zij geldt nu ook buiten de browser.
+
+## De webversie
+
+**[lekteo.eu](https://lekteo.eu/nl)** — dezelfde motor, in de browser, zonder
+installatie. Handig wanneer u gewoon een factuur wilt bekijken, of een hele map
+wilt verwerken met een exporteerbaar overzicht.
+
+De [MCP-pagina](https://lekteo.eu/nl/mcp) behandelt hetzelfde, in vier talen.
+
+## Steunen
+
+Deze server is gratis en blijft dat. Bespaart hij u tijd op het werk, dan staat
+er een link om te steunen op [lekteo.eu](https://lekteo.eu/nl) — in de
+antwoorden van het hulpmiddel zal er nooit een staan.