InvoiceIn

io.github.peculiar-systemsPublished by GitHub account peculiar-systemsv0.1.3Updated Nov 2, 2026

XRechnung, Factur-X, Peppol, PINT AE, FatturaPA, KSeF → JSON + fix hints. Hosted; MIT=examples only

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Hosted MCP server that parses and validates received European and UAE e-invoices, returning canonical EN 16931 JSON, verdicts, HTML, CSV or DATEV exports.

What you can do
  • Parse one e-invoice into canonical EN 16931 JSON with seller, buyer, lines, totals and payment details
  • Validate an invoice against official rule sets (XSD, EN 16931, XRechnung, Peppol BIS, PINT AE, FatturaPA, KSeF, arithmetic) and list errors and warnings
  • Render an invoice as a self-contained printable HTML page with labels in a chosen language
  • Export an invoice as a flat CSV table for spreadsheets or database import
  • Convert a received purchase invoice into a DATEV Buchungsstapel import file for German bookkeeping
When to use it
Useful when an assistant has to check, read or reformat e-invoices a business received — XRechnung, Factur-X/ZUGFeRD, Peppol, FatturaPA, KSeF, RO e-Factura or PINT AE — for bookkeeping, data entry or a quick validity check.
Requirements
Remote streamable HTTP endpoint; no local runtime or package. An X-Api-Key header is optional: without it a demo quota of 20 invoices per day per IP applies, and a trial key comes from the product page. Requests must send a real User-Agent.
Before you install
Invoice documents are uploaded to a third-party hosted service; the README says nothing is stored, but the content still leaves your machine. Without a key, usage is limited per IP. Validation results are informational, not legal advice. The service is not open source.

Installation

In SourceWeft

  1. Open InvoiceIn in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.peculiar-systems%2Finvoicein/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "invoicein": {
      "type": "http",
      "url": "https://invoicein-api.peculiar.systems/mcp"
    }
  }
}

README

InvoiceIn — examples

[MCP server rated A on Glama] [Run in Postman]

Any European or UAE (PINT AE) e-invoice a business receives → one canonical EN 16931 JSON, a validation report with plain-language fix hints, a PDF, CSV or DATEV export. One stateless endpoint, nothing stored.

Accepts: XRechnung (UBL and CII), EN 16931 UBL 2.1 Invoice/CreditNote, Peppol BIS Billing 3, CII D16B, ZUGFeRD 1.0 / 2.x and Factur-X hybrid PDFs, Italy's FatturaPA 1.2, Poland's KSeF FA(2)/FA(3), Romania's RO e-Factura (CIUS-RO), the UAE's PINT AE (Billing and Self-Billing).

Validated against: EN 16931 validation artefacts 1.3.17, XRechnung 3.0.2 (KoSIT Schematron 2.6.0), Peppol BIS Billing 3, FNFE CTC-FR 1.4.0.04 (the BR-FR rules; runs when seller and buyer are both established in France), CIUS-RO 1.0.1, OpenPeppol's PINT AE 1.0.4 for the UAE (free check page: https://invoicein.peculiar.systems/uae), the UBL, CII, FatturaPA and KSeF schemas — plus arithmetic cross-checks on every format and market conventions no Schematron reads (German Skonto terms in free text, the Polish KSeF number). The live list with versions is at GET /v1/formats.

This repository holds runnable examples, sample invoices you can test with, and the MCP registry manifest. The service itself is not open source.

Nothing you send is stored: the document is parsed in memory and the response is built from it. Privacy (full policy) · Terms

The bridge in bridge/ is a transparent proxy, not a second implementation: it mirrors whatever tools/list returns from the hosted server, so the two can never drift. The five tools and their annotations — all read-only, non-destructive, idempotent, closed-world — are in bridge/tools.json, checked by tests/. A static analyser reading the bridge source alone sees one dispatch callback and no tools; that is the proxy, not the tool surface.

60 seconds

bash
curl -X POST "https://invoicein-api.peculiar.systems/v1/invoice?include=validation&lang=en" \  -H "X-Api-Key: $INVOICEIN_KEY" \  -F file=@samples/factur-x-en16931.pdf

No key yet? Leave the header out: 5 invoices a day per IP, same output, and every answer says how many are left. A free key — 100 invoices, no card, no expiry — is issued at once, on the product page or with one call:

bash
curl -X POST "https://invoicein-api.peculiar.systems/v1/keys" \  -H "Content-Type: application/json" -d '{"email": "[email protected]"}'

The response (full example):

jsonc
{  "ok": true,  "source":  { "syntax": "UBL", "format": "peppol-bis3", "profile": "Peppol BIS Billing 3.0", "container": "xml" },  "invoice": {                         // canonical EN 16931, field names carry BT/BG numbers in /v1/schema    "document": { "id": "Snippet1", "issue_date": "2017-11-13", "type_code": "380", "currency": "EUR", "due_date": "2017-12-01", ... },    "seller":   { "name": "SupplierOfficialName Ltd", "vat_id": "GB1232434", "electronic_address": { "value": "9482348239847239874", "scheme": "0088" }, ... },    "buyer":    { ... },    "lines":    [ { "id": "1", "quantity": 7, "unit": "DAY", "net_amount": 2800, "tax": { "category": "S", "rate": 25 }, "item": { "name": "item name" } }, ... ],    "tax_breakdown": [ { "taxable_amount": 1325, "tax_amount": 331.25, "category": "S", "rate": 25 } ],    "totals":   { "line_net": 1300, "charges": 25, "net": 1325, "tax": 331.25, "gross": 1656.25, "due": 1656.25 },    "payment":  { "means_code": "30", "remittance_info": "Snippet1", "credit_transfers": [ { "iban": "IBAN32423940", "account_name": "AccountName", "bic": "BIC324098" } ] }  },  "validation": { "valid": true, "errors": 0, "warnings": 0,                  "rule_sets": [ { "id": "XSD:ubl-invoice" }, { "id": "EN16931-UBL", "version": "EN 16931 validation artefacts 1.3.17" }, { "id": "Peppol-UBL" } ],                  "issues": [] },  "timings_ms": { "detect": 0.5, "map": 14.4, "validate": 86.0, "total": 100.8 },  "credits": { "mode": "key", "remaining": 99 }}

When something is wrong, every failed rule carries a hint in the requested language (example, KSeF FA(3) in Polish):

jsonc
{ "id": "XSD-UNEXPECTED-ELEMENT", "severity": "error", "rule_set": "XSD:fa3",  "message": "Element '{http://crd.gov.pl/wzor/2025/06/25/13775/}Adnotacje': This element is not expected. Expected is one of ( {http://crd.gov.pl/wzor/2025/06/25/1 …",  "hint": "XML zawiera element, którego schemat nie dopuszcza w tym miejscu. Nazwa elementu jest błędna, element należy do innego profilu/wersji (np. UBL 2.0 lub ZUGFeRD EXTENDED), jest zdublowany albo jest własnym rozszerzeniem. Usuń go lub zmień jego nazwę.",  "who": "sender", "location": "/*/*[4]/*[8]", "line": 43 }

Endpoints

CallReturns
POST /v1/invoice?include=validation,html,pdf,csv,datev&lang=en|de|pl|it|freverything in one JSON (extras base64/inline)
POST /v1/parsecanonical JSON only
POST /v1/validatevalidation report only
POST /v1/render.html · POST /v1/render.pdfhuman-readable rendering, labels in the five languages
POST /v1/export.csv?level=lines|documentsflat CSV
POST /v1/export.datev?skr=03|04&creditor_account=70000DATEV Buchungsstapel (EXTF 700, cp1252)
GET /v1/formats · GET /v1/rules/{id}?lang=de · GET /v1/schemaformats + rule versions · explain a rule id · field guide
GET /v1/countrieswhich format each country's mandate asks for, and what we validate it with
GET /v1/vat/{number}EU VAT number: format offline, then live VIES, with a dated receipt
GET /v1/peppol/{id}is a counterparty published on Peppol, and what can it receive

Body: multipart field file, or the raw XML/PDF. Send a real User-Agent (Cloudflare rejects the default Python-urllib one with error 1010). Auth: X-Api-Key or Authorization: Bearer. One invoice = one credit whatever outputs you request; a file that carries several invoices (a FatturaPA lot) costs one per invoice. Remaining credits come back in X-Credits-Remaining.

Examples in this repo

Sample invoices

FileWhat it isSource / licence
samples/xrechnung-3.0-ubl.xml, samples/xrechnung-3.0-cii.xmlthe same XRechnung 3.0 invoice in both syntaxesKoSIT XRechnung testsuite, Apache-2.0
samples/peppol-bis3-base-example.xmlPeppol BIS Billing 3 base exampleOpenPeppol, Apache-2.0
samples/factur-x-en16931.pdfFactur-X hybrid PDF, EN 16931 profileZUGFeRD corpus (FNFE-MPE examples), Apache-2.0
samples/ksef-fa3-przyklad-1.xmlKSeF FA(3) official example no. 1Polish Ministry of Finance, public
samples/fatturapa-fpr01.xmlFatturaPA 1.2 official example FPR01Agenzia delle Entrate, public

Both XRechnung files produce the same canonical JSON (only the syntax-specific extensions block differs) — that is the point of the canonical model.

What it does not do

No OCR (a PDF without embedded XML is rejected with pdf-no-xml). Not a Peppol access point, not a French PDP, not a UAE Accredited Service Provider, not a KSeF or SdI client: it reads what you already received and never transmits an invoice anywhere. Factur-X/ZUGFeRD profiles below EN 16931 (MINIMUM, BASIC WL, BASIC) get schema and arithmetic checks only, because the EN 16931 rules would only produce noise there. Validation results are informational, not legal advice.

Licence

The examples in this repository are MIT. Sample invoices keep the licences listed above.

Source: README.md at commit 4657145

Tools

5

read_invoice

Read invoice

Parse one European or UAE (PINT AE) e-invoice into canonical EN 16931 JSON and validate it against the official rule sets in the same call. Use it when you need the invoice content (seller, buyer, lines, totals, payment) together with the verdict; use validate_invoice for a verdict-only answer, invoice_to_html / invoice_to_csv / invoice_to_datev for renderings. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the parsed invoice, the validation report with fix hints in `lang`, and timings; an unreadable file returns ok=false with error.code/message/hint instead of raising. A FatturaPA lot returns only its first invoice, with a note. For a Polish KSeF invoice, pass the KSeF number in `ksef`: it is checked against the invoice and returned on payment.ksef_number. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

Parameterskseflangpathfile_base64

validate_invoice

Validate invoice

Validate one European or UAE (PINT AE) e-invoice against the official rule sets (XSD, EN 16931, XRechnung, Peppol BIS, PINT AE, FatturaPA, KSeF, arithmetic) and return the verdict without the invoice body. Use it for pass/fail and the list of errors and warnings; use read_invoice when you also need lines, totals and payment data. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the validation report (valid flag, counts, rule sets with versions, failed rules with rule id, severity, fix hint in `lang`, affected field and who must act), the detected source and the document header; an unreadable file returns ok=false with error.code/message/hint instead of raising. For a Polish KSeF invoice, a KSeF number passed in `ksef` is checked too: shape, NIP check digit, and agreement with the invoice it came with. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

Parameterskseflangpathfile_base64

invoice_to_html

Render invoice as HTML

Render one European e-invoice as a self-contained, printable HTML page: header, seller and buyer, line items, VAT breakdown, totals and payment details in one layout regardless of the source syntax, labels in `lang`. Use it to show an invoice to a person or to print it to PDF from a browser; it does not validate (use validate_invoice) and is not an accounting export (use invoice_to_csv or invoice_to_datev). Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the HTML document as one text string with inline CSS and no external assets; an unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

Parameterskseflangpathfile_base64

invoice_to_csv

Export invoice as CSV

Export one European e-invoice as a flat CSV table for a spreadsheet or a database import. Document columns: invoice id, type, issue and due date, currency, seller and buyer name / VAT id / country, buyer and order reference, net / tax / gross / due totals, IBAN, BIC, remittance info, KSeF number, detected format and profile; with level=lines each row adds line id, item name, seller item id, quantity, unit, unit price, net amount, VAT category and rate, note. Use invoice_to_datev for DATEV bookkeeping and read_invoice for the full JSON. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). A FatturaPA lot yields rows for every invoice in it. Returns the CSV as one text string: comma-separated, header row first, LF line endings, decimal point; an unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

Parametersksefpathlevelfile_base64

invoice_to_datev

Export invoice as DATEV Buchungsstapel

Convert one received (purchase) e-invoice into a DATEV Buchungsstapel import file (EXTF format 700) for German bookkeeping in DATEV Kanzlei-Rechnungswesen or Unternehmen online. Use it only for incoming invoices booked on the German side; use invoice_to_csv for a generic table, read_invoice for the raw data, validate_invoice for rule checks (this tool does not validate). Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the file content as one text string, decoded in UTF-8: the EXTF header line, the DATEV column header, then one booking row per VAT-rate group with the gross amount and S/H flag (H for credit notes), the expense account chosen by rate under the selected SKR (e.g. SKR03 3400 for 19 %, 3300 for 7 %, 3200 for 0 %, 3120 intra-EU, 3425 reverse charge), the creditor account as Gegenkonto, document and due date, invoice number in Belegfeld 1, seller name as Buchungstext and the seller VAT id on intra-EU / reverse-charge rows. Save it as UTF-8 with CRLF before importing; the account mapping is a default to confirm with the tax advisor. An unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

Parametersskrpathfile_base64creditor_account

Version history

2
  1. v0.1.3LatestSep 25, 2026
  2. v0.1.2Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts