de en es ja ko ru zh

mcp-einvoicing-core

Name: mcp-einvoicing-core
Author: cmendezs

by cmendezs

Overview Schema Related Servers Score Discussions

Python

mcp-einvoicing-core

License PyPI version Python

Themen: mcp mcp-server e-invoicing electronic-invoicing european-invoicing python fastmcp peppol en16931 ubl fatturapa xp-z12-013 xml base-library

Basispaket für europäische elektronische Rechnungsstellungs-MCP-Server.

Stellt abstrakte Basisklassen, gemeinsame Pydantic-Modelle, XML-Dienstprogramme und einen HTTP-Client bereit, damit länderspezifische Pakete (mcp-facture-electronique-fr, mcp-fattura-elettronica-it, …) eine gemeinsame Grundlage nutzen können, ohne Code zu duplizieren.

Was dieses Paket bietet

Modul	Inhalt	Verwendet von
`models.py`	`InvoiceParty`, `InvoiceLineItem`, `VATSummary`, `PaymentTerms`, `InvoiceDocument`, `DocumentValidationResult`	IT (strukturierte Rechnungserstellung), zukünftig BE/PL/DE/ES
`base_server.py`	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseDocumentParser`, `BaseLifecycleManager`, `BasePartyValidator`, `EInvoicingMCPServer`	Alle Länder-Adapter
`xml_utils.py`	`format_amount`, `format_quantity`, `validate_date_iso`, `validate_iban`, `xml_element`, `xml_optional`, `format_error`, `filter_empty_values`	IT (wortwörtlich übernommen), zukünftige XML-basierte Formate
`http_client.py`	`TokenCache`, `OAuthConfig`, `BaseEInvoicingClient` (OAuth2 + no-auth)	FR (wortwörtlich übernommen), zukünftige API-basierte Länder
`exceptions.py`	`EInvoicingError`, `ValidationError`, `PartyValidationError`, `XSDValidationError`, `DocumentGenerationError`, `AuthenticationError`, `PlatformError`	Alle Länder-Adapter
`logging_utils.py`	`setup_logging`, `get_logger`	Alle Länder-Adapter

Related MCP server: mcp-facture-electronique-fr

Installation

pip install mcp-einvoicing-core

Dieses Paket hat keine länderspezifischen Abhängigkeiten. lxml (benötigt für XSD-Validierung in IT und zukünftigen Ländern) wird von jedem Länderpaket individuell deklariert.

Architektur

mcp-einvoicing-core           ← this package
  ├── BaseDocumentGenerator   ← abstract: generate(InvoiceDocument) → str
  ├── BaseDocumentValidator   ← abstract: validate(xml) → DocumentValidationResult
  ├── BaseDocumentParser      ← abstract: parse(xml) → dict
  ├── BaseLifecycleManager    ← abstract: submit/search/get_status (async HTTP)
  ├── BasePartyValidator      ← abstract: validate_seller/buyer/tax_id
  ├── BaseEInvoicingClient    ← concrete: async HTTP + OAuth2/no-auth/token
  ├── InvoiceDocument (Pydantic)  ← shared data model
  └── EInvoicingMCPServer     ← plugin registry wrapping FastMCP

mcp-facture-electronique-fr   ← country adapter (FR)
  ├── PAConfig(OAuthConfig)
  ├── FlowClient(BaseEInvoicingClient)      ← OAuth2, XP Z12-013 Annex A
  ├── DirectoryClient(BaseEInvoicingClient) ← OAuth2, XP Z12-013 Annex B
  └── FrLifecycleManager(BaseLifecycleManager)

mcp-fattura-elettronica-it    ← country adapter (IT)
  ├── ItalyPartyValidator(BasePartyValidator)   ← Partita IVA modulo-10
  ├── FatturaGenerator(BaseDocumentGenerator)   ← FatturaPA XML v1.6.1
  ├── FatturaValidator(BaseDocumentValidator)   ← lxml XSD v1.6.1
  └── FatturaParser(BaseDocumentParser)         ← lxml xpath

Plugin-Registrierungsmuster

Länderpakete registrieren ihre Tools auf einer gemeinsamen oder eigenständigen FastMCP-Instanz:

# Standalone (existing server.py — no changes required)
from fastmcp import FastMCP
mcp = FastMCP(name="mcp-fattura-elettronica-it", instructions="…")
register_header_tools(mcp)
register_body_tools(mcp)
register_global_tools(mcp)

# Multi-country (optional EInvoicingMCPServer)
from mcp_einvoicing_core import EInvoicingMCPServer
server = EInvoicingMCPServer(name="mcp-einvoicing-eu", instructions="…")
server.register_plugin(register_header_tools, "it-header")
server.register_plugin(register_flow_tools, "fr-flow")
server.run()

Kompatibilität mit Claude Desktop / Cursor / Kiro

Bestehende Konfigurationen für mcp-facture-electronique-fr und mcp-fattura-elettronica-it erfordern keine Änderungen: Tool-Namen, Signaturen, Umgebungsvariablen und Einstiegspunkte (server:main) bleiben vollständig erhalten.

Roadmap-Kompatibilität

Land	Status	Standard	Transport	Erbt von	Überschreibt	Bekannte Lücken
🇫🇷 FR	✅ Erledigt	XP Z12-013	Hybrid / PPF-Hub	`BaseEInvoicingClient`, `BaseLifecycleManager`	`submit_lifecycle_status`, `healthcheck`	Keine
🇮🇹 IT	✅ Erledigt	FatturaPA v1.6.1	Direkt / SDI	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseDocumentParser`, `BasePartyValidator`	alle abstrakten Methoden	`to_invoice_document()` noch nicht implementiert
🇧🇪 BE	✅ Erledigt	Peppol BIS 3.0	AS4 / Peppol	alle Basisklassen	`generate()` → UBL 2.1, `validate()` → Schematron EN16931	Keine
🇵🇱 PL	🔄 In Arbeit	KSeF FA(2)	Direkt-API	`BaseDocumentGenerator`, `BaseDocumentValidator`, `BaseLifecycleManager`	KSeF-Sitzungs-Auth-Flow	`MTLS`-Auth-Modus noch nicht implementiert
🇩🇪 DE	🔄 In Arbeit	ZUGFeRD / XRechnung	AS4 / Peppol	alle Basisklassen	`generate()` gibt PDF-Bytes zurück (base64)	`generate()` Rückgabetyp: Mehrdeutigkeit zwischen `str` und `bytes`
🇪🇸 ES	🔄 In Arbeit	FACeB2B / FacturaE	Direkt-API	alle Basisklassen	mTLS-Auth	`MTLS`-Auth-Modus noch nicht implementiert
🇷🇴 RO	📋 Backlog	RO-UBL (EN 16931)	Direkt-API / Clearance	`BaseDocumentGenerator`, `BaseLifecycleManager`	ANAF-Clearance-Flow	`BaseSchematronValidator`-Variante erforderlich
🇬🇷 GR	📋 Backlog	myDATA XML	Direkt-API / Reporting	`BaseEInvoicingClient`, `BaseLifecycleManager`	myDATA-Auth + Reporting-Flow	myDATA-API-Client noch nicht entworfen
🇳🇱🇸🇪🇩🇰🇳🇴 Nordics/NL	📋 Backlog	Peppol BIS 3.0 / UBL	AS4 / Peppol	alle Basisklassen	`generate()` → UBL 2.1, `validate()` → Schematron	Nutzt BE AS4-Transportschicht wieder
🇵🇹 PT	📋 Backlog	CIUS-PT + QR-Code	Signatur / direkt	`BaseDocumentGenerator`, `BaseDocumentValidator`	Qualifizierte Signatur + QR-Injektion	Integration qualifizierter Signaturen nicht entworfen

Architektonische Hinweise

Transport-Schnittstelle

Da die Anzahl der Adapter wächst, wird eine TransportInterface-Abstraktion im Core Duplikate über Länder hinweg verhindern, die dieselbe Transportschicht nutzen:

Transport	Länder
Direkt-API (Clearance / Reporting)	FR, RO, GR, HU
AS4 / Peppol-Netzwerk	BE, DE, Nordics/NL
Hybrid / Hub	FR (PPF/PDP dualer Pfad)

Deutschland: 80% Wiederverwendung von FR

Das deutsche Mandat (aktiv seit Jan 2025 für B2B-Empfang) bevorzugt stark ZUGFeRD/Factur-X — dasselbe in PDF eingebettete XML-Modell wie das französische Factur-X-Profil. Die XML-Generierungs- und Validierungslogik von mcp-facture-electronique-fr kann mit minimalen Änderungen wiederverwendet werden, was DE zum nächsten Adapter mit dem geringsten Aufwand nach BE macht.

ViDA / DRR (2030)

Bis Juli 2030 müssen sich alle nationalen Systeme an die EU-Vorgaben zur digitalen Berichterstattung (Digital Reporting Requirement) für grenzüberschreitende Transaktionen anpassen. Die Verwendung von EN 16931 als internes InvoiceDocument-Datenmodell in diesem Kernpaket macht das Projekt bereits zukunftssicher: Länder-Adapter übersetzen EN 16931 → lokales Format, nicht umgekehrt.

Lizenz

Apache 2.0 — siehe LICENSE.

Install Server

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4dRelease cycle

29Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

einvoice-mcp
Finance App Automation
makririch
A
license
A
quality
D
maintenance
MCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.
Updated 4 months ago (2026-04-13 15:27 UTC)
6
56
2
MIT
mcp-facture-electronique-fr
Payments & Billing Finance
cmendezs
A
license
A
quality
C
maintenance
Model Context Protocol (MCP) server for French Electronic Invoicing (NF XP Z12-013). Provide tools to validate, generate, and explore API specifications for PDP/OD interoperability.
Updated 8 days ago (2026-08-09 07:44 UTC)
34
Apache 2.0
mcp-fattura-elettronica-it
Finance Payments & Billing
cmendezs
A
license
A
quality
A
maintenance
Model Context Protocol (MCP) server for Italian Electronic Invoicing (FatturaPA / SDI). Provide tools to validate, generate, and explore API specifications for Sistema di Interscambio (SDI) interoperability.
Updated 6 days ago (2026-08-11 15:45 UTC)
27
1
Apache 2.0
mcp-einvoicing-be
Finance Payments & Billing
cmendezs
A
license
A
quality
A
maintenance
Model Context Protocol (MCP) server for Belgian Electronic Invoicing (Peppol BIS 3.0 / PINT-BE / Mercurius). Provides tools to validate, generate, and transform UBL 2.1 e-invoices, and look up BCE/KBO enterprise data and Peppol participants.
Updated 8 days ago (2026-08-09 07:44 UTC)
7
Apache 2.0

View all related MCP servers

Related MCP Connectors

fiscal
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
InvoiceXML
Create, validate, convert & extract compliant e-invoices (UBL, Factur-X, ZUGFeRD, XRechnung)
Second Eyes Agent Workflow Services
Workflow diagnostics, capability routing, and x402 settlement for MCP-compatible agents.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cmendezs/mcp-einvoicing-core'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-einvoicing-core

Was dieses Paket bietet

Installation

Architektur

Plugin-Registrierungsmuster

Kompatibilität mit Claude Desktop / Cursor / Kiro

Roadmap-Kompatibilität

Architektonische Hinweise

Transport-Schnittstelle

Deutschland: 80% Wiederverwendung von FR

ViDA / DRR (2030)

Lizenz

Maintenance

Resources

Looking for Admin?

Related MCP Servers

einvoice-mcp

mcp-facture-electronique-fr

mcp-fattura-elettronica-it

mcp-einvoicing-be

Related MCP Connectors

Latest Blog Posts

MCP directory API