EU Compliance & Factur-X MCP Server
Enables GitHub Actions CI/CD workflows to automatically validate Factur-X/EN 16931 invoices, fail builds on compliance errors, write markdown reports to the step summary, and expose outputs such as compliance-status, issues-count, and report-path.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🇪🇺 EU Compliance & Factur-X MCP Server & GitHub Action
Zero-dependency Model Context Protocol (MCP) server & GitHub Action empowering AI coding environments (Claude Desktop, Cursor, Antigravity) and CI/CD pipelines to validate EN 16931 / Factur-X electronic invoices, audit AI systems against the EU AI Act, and evaluate GDPR & NIS2 readiness directly in your workflow.
🚀 Quick Start: GitHub Actions CI/CD
Automatically validate Factur-X XML invoices in your billing, e-commerce, or ERP repo:
name: Validate Factur-X E-Invoices
on:
pull_request:
branches: [ main ]
push:
branches: [ main ]
jobs:
validate-invoices:
runs-on: ubuntu-latest
steps:
- name: Checkout Code
uses: actions/checkout@v4
- name: Validate Factur-X / EN 16931 Invoices
uses: EroNiiChan/mcp-eu-compliance@v1
with:
mode: 'validate-facturx'
path: './invoices'
fail-on-error: 'true'
output-file: 'facturx-compliance-report.md'Outputs markdown summary into $GITHUB_STEP_SUMMARY and sets $GITHUB_OUTPUT variables (compliance-status, issues-count, report-path).
Related MCP server: ai-act-mcp
⚡ Why This Matters in 2025–2027
European regulation is fundamentally changing software development and B2B commerce:
EU AI Act (Regulation (EU) 2024/1689):
Prohibited AI systems face immediate market bans and fines up to €35,000,000 or 7% of worldwide annual turnover.
High-risk systems (HR, credit, education, biometrics, critical infrastructure) require continuous risk management, data bias testing, technical documentation, human oversight, and CE marking.
Mandatory B2B Electronic Invoicing (EN 16931 & Factur-X):
France, Germany (e-Rechnung), Poland, and EU member states are making structured electronic invoices mandatory for B2B transactions. Traditional PDFs are no longer compliant.
NIS2 Directive & GDPR:
Stringent 24h early warning incident reporting and €10M+ penalties for supply chain security oversights.
With mcp-eu-compliance, your LLM agent acts as an in-IDE European regulatory officer and electronic invoicing engine.
📦 Features
Zero External Dependencies: Pure Python standard library (
sys,json,xml.etree.ElementTree,datetime). Runs on any machine with Python 3.9+ withoutpip installheadaches.EU AI Act Risk Auditor (
audit_eu_ai_act):Classifies AI systems: Unacceptable / Prohibited (Art 5), High Risk (Annex III & Annex I), GPAI Systemic Risk (FLOPs ≥ 10²⁵), Transparency (Art 50), or Minimal Risk.
Generates Article 9–15 mandatory checklists, enforcement deadlines, and maximum penalty exposure.
Factur-X / EN 16931 Generator (
generate_facturx_invoice):Emits compliant UN/CEFACT CII (
CrossIndustryInvoice) XML.Supports
MINIMUM,BASIC, andEN16931(Comfort) profiles with line items, multi-rate VAT breakdown, and SEPA payment details.
Factur-X XML Validator (
validate_facturx_xml):Validates XML structure, namespaces, profile identifiers, and verifies arithmetic summation across line net totals, VAT bases, and gross payable amounts.
GDPR & NIS2 Readiness Evaluator (
check_gdpr_nis2_readiness):Scans organizational size and sector to detect Essential vs Important Entity status under NIS2, missing incident response plans, and GDPR DPO triggers.
Enterprise Pro Licensing (
get_compliance_status_and_pro_license):Seamless in-IDE verification of Pro licenses for Peppol routing and automated hybrid PDF/A-3 compilation.
🚀 Quick Setup
1. Claude Desktop
Add to your claude_desktop_config.json:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"eu-compliance": {
"command": "python",
"args": [
"C:\\Users\\Ender\\Documents\\Money\\swarm\\agent18_mcp_server\\mcp_eu_compliance.py"
]
}
}
}2. Cursor IDE
In Cursor Settings → Features → MCP:
Name:
eu-complianceType:
commandCommand:
python c:\path\to\mcp_eu_compliance.py
3. Google Antigravity / AGY
In your agy MCP configuration or agent configuration:
{
"mcpServers": {
"eu_compliance": {
"command": "python",
"args": ["c:/path/to/mcp_eu_compliance.py"]
}
}
}🛠️ Tool Specifications & Prompts
1. audit_eu_ai_act
Example Prompt in IDE:
"Audit our new automated candidate resume screening and interview scoring tool under the EU AI Act."
Arguments:
system_name(str): System name.description(str): Architecture and functionality summary.intended_purpose(str): Use case (e.g. CV screening, credit evaluation, bot).sector(str, optional): Industry sector (e.g.employment,finance,healthcare).biometrics_used(bool, optional): Uses biometric data or facial processing.affects_fundamental_rights(bool, optional): Potential rights impact.is_gpai(bool, optional): Is it a general-purpose AI / foundation model.training_flops(float, optional): Total compute FLOPs (≥ 1e25 designates systemic risk).
Output Preview:
{
"classification": "HIGH_RISK",
"risk_level": "HIGH RISK (Annex III / Annex I)",
"matched_high_risk_domains": [
{
"domain": "employment",
"annex": "Annex III (4)",
"title": "Employment, Workers Management & Access to Self-Employment"
}
],
"mandatory_requirements": [
{"code": "ART_9_RMS", "title": "Risk Management System"},
{"code": "ART_10_DATA_GOV", "title": "Data Governance & Bias Mitigation"},
{"code": "ART_11_TECH_DOC", "title": "Technical Documentation & Annex IV"},
{"code": "ART_14_HUMAN_OVERSIGHT", "title": "Human Oversight (HITL / HOTL)"},
{"code": "ART_48_CE_MARK", "title": "CE Marking of Conformity"},
{"code": "ART_71_EU_DATABASE", "title": "EU Database Registration"}
],
"penalties": {
"High-Risk Non-Compliance (Arts 9-15)": "Up to €15,000,000 or 3% of total worldwide annual turnover."
}
}2. generate_facturx_invoice
Example Prompt in IDE:
"Generate a Factur-X EN 16931 invoice for 500 EUR consulting services with 20% French VAT."
Arguments:
invoice_number(str): e.g."INV-2026-001"issue_date(str):"YYYY-MM-DD"seller(object):name,country_code,vat_id,siret,iban,bic, address.buyer(object):name,country_code,vat_id,siret, address.items(array):name,quantity,unit_price,vat_rate.currency(str, default 'EUR')profile(str, default 'EN16931'):MINIMUM,BASIC,EN16931,EXTENDED.
Output:
Returns pure UN/CEFACT CII XML ready to be saved as factur-x.xml or embedded into PDF/A-3.
3. validate_facturx_xml
Example Prompt in IDE:
"Verify if this Factur-X XML complies with the EN 16931 standard."
Arguments:
xml_content(str): XML string to validate.
Output:
{
"is_valid": true,
"errors": [],
"warnings": [],
"details": {
"invoice_number": "INV-2026-001",
"profile_name": "EN16931",
"profile_urn": "urn:cen.eu:en16931:2017",
"grand_total_amount": 600.0,
"seller_name": "Hexagon Software SAS",
"buyer_name": "Acme Consulting GmbH"
},
"standards_compliance": "EN 16931-1:2017 & UN/CEFACT CII D16B"
}💎 Community vs. Pro Enterprise Tier
Feature | Community Edition (Free) | Pro Enterprise Tier |
EU AI Act Risk Classification & Checklist | ✅ Full Art 5–15 | ✅ Full Art 5–15 |
Factur-X / EN 16931 XML Generation | ✅ All Profiles | ✅ All Profiles |
Monetary & XML Schema Validation | ✅ Included | ✅ Included |
GDPR & NIS2 Rapid Auditor | ✅ Included | ✅ Included |
Zero-Dependency Local StdIO Execution | ✅ Yes | ✅ Yes |
Automated PDF/A-3 Hybrid Compilation | Manual | ⚡ Automated (X.509 Signed) |
Direct Peppol AS4 & Chorus Pro Routing | — | ⚡ Automated API Dispatch |
CI/CD Continuous AI Act RegWatch Scanner | — | ⚡ Automated PR Checks |
Signed EU Conformity Assessment Dossier | — | ⚡ Automated PDF Export |
Upgrading to Pro:
Price: $49/month or $299 lifetime license.
Sponsor / Purchase: GitHub Sponsors @EroNiiChan or Polar.sh.
Enter key via IDE: Call
get_compliance_status_and_pro_license(pro_license_key="EUPRO-XXXX-XXXX-XXXX").
🧪 Testing
Run the included automated test suite (10/10 tests covering AI Act classifications, XML arithmetic, schema validation, and JSON-RPC 2.0 stdio pipes):
python test_mcp_server.pyExpected output:
..........
----------------------------------------------------------------------
Ran 10 tests in 0.093s
OK📜 Regulatory Reference
Regulation (EU) 2024/1689 (Artificial Intelligence Act): Official Journal L, 12.07.2024
Directive (EU) 2022/2555 (NIS2 Directive): EUR-Lex
Directive 2014/55/EU on electronic invoicing in public procurement & EN 16931-1:2017
Factur-X / ZUGFeRD 2.2: FNFE-MPE & FeRD Specifications
🤝 Contributing & Support
Issues, PRs, and suggestions are welcome!
Author: @EroNiiChan
Sponsorship: Support on GitHub Sponsors
License: Apache-2.0
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
EU AI Act and GDPR checks with sources: classify an AI system, trace each duty, find the supervisor.
Deterministic European sovereign engine with 90 tools across 20 vertical suites for AI agents: EU Tax/KYB, FatturaPA/Peppol, AI Act, GDPR, DORA, NIS2, Italian Tenders (D.Lgs 36/2023), CBAM, EUDR, and Labour Law. Zero-Data-Retention with verifiable SHA-256 PDF/A audit certificates.
Deterministic, sourced EU compliance checks: NIS2, DORA, GDPR, Cyber Resilience Act and AI Act.
Official EU regulation for your AI assistant. Search the AI Act, GDPR, DORA, NIS2 and Cyber Resilience Act. Read exact articles, paragraphs, recitals and annexes, check quotations against the source and follow guided compliance research workflows. For compliance teams, DPOs, security leads and in-house counsel. Free during beta; sign in with your email. --- Oficialūs ES teisės aktai jūsų DI asistente (Claude, ChatGPT ir kt.). Ieškokite DI akte, BDAR, DORA, NIS2 ir Kibernetinio atsparumo akte. Skaitykite tikslius straipsnius, dalis, konstatuojamąsias dalis ir priedus, tikrinkite citatas pagal šaltinį ir naudokitės atitikties tyrimo darbo eigomis. Atitikties, duomenų apsaugos ir kibernetinio saugumo specialistams bei įmonių teisininkams. Beta laikotarpiu nemokama; prisijunkite el. paštu.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for EU AI Act compliance classification with multi-jurisdiction overlay across 8 frameworks (NIST AI RMF, ISO 42001, GDPR, HIPAA, Colorado SB 24-205). Provides deterministic risk classifier (quick_risk_class) and Claude-powered Annex III deep classifier (classify_annex3) with remediation actions.29 npmMIT
- AlicenseAqualityDmaintenanceEnables EU AI Act compliance assessment by classifying AI systems, listing obligations, computing deadlines, and scanning repos for required documentation, all running locally.42MIT

Legalithmofficial
AlicenseAqualityBmaintenanceEU AI Act compliance in your editor.Classify risk, cite obligations, draft Article 50 disclosures. Offline, no API key.71MIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to locally parse, validate, audit, explain, generate, and convert XRechnung and ZUGFeRD/Factur-X e-invoices using official rule sets, fully offline with no API keys required.Apache 2.0