README.md
Generate, validate, and submit Factur-X compliant electronic invoices.
facturx-mcp
Serveur MCP pour la facturation électronique Factur-X — générez, validez et soumettez des factures conformes à la norme EN 16931 et à la réforme française B2B 2026 directement depuis Claude.
Installation
npm install -g facturx-mcp
Configuration Claude Desktop
Ajoutez dans ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :
{
"mcpServers": {
"facturx": {
"command": "facturx-mcp",
"env": {
"FACTURX_LICENSE_KEY": "FTRX-..."
}
}
}
}
Sans clé de licence, le mode gratuit est actif (10 générations/jour).
Outils disponibles
| Outil | Plan | Description |
|---|---|---|
facturx_generate |
Gratuit (10/j) | Générer un XML Factur-X valide (EN 16931) |
facturx_validate |
Gratuit | Valider les données avant génération |
facturx_parse |
Gratuit | Parser un XML Factur-X existant |
facturx_compute_totals |
Gratuit | Calculer HT / TVA / TTC |
facturx_create_pdf |
Pro | Créer un PDF avec XML embarqué |
facturx_extract_from_pdf |
Pro | Extraire le XML depuis un PDF |
chorus_submit |
Pro | Soumettre sur Chorus Pro (B2G) |
chorus_get_status |
Pro | Statut d'une facture CPP |
chorus_list_invoices |
Pro | Lister les factures Chorus Pro |
Tarifs
- Gratuit — 10 générations/jour, outils Factur-X de base
- Pro — 9.99 €/mois — Outils illimités + Chorus Pro → Acheter maintenant
- Enterprise — 49.99 €/mois — Multi-comptes Chorus Pro + support prioritaire
Variables d'environnement
| Variable | Obligatoire | Description |
|---|---|---|
FACTURX_LICENSE_KEY |
Non | Clé de licence Pro (format FTRX-...) |
CHORUS_CLIENT_ID |
Pro | Client ID PISTE (Chorus Pro) |
CHORUS_CLIENT_SECRET |
Pro | Client Secret PISTE |
CHORUS_LOGIN |
Pro | Login compte technique Chorus Pro |
CHORUS_PASSWORD |
Pro | Mot de passe compte technique |
CHORUS_SANDBOX |
Non | true pour le bac à sable (défaut: true) |
Exemple
Génère une facture pour ma prestation du mois :
- Vendeur : ACME SAS, TVA FR12345678901, 10 rue de la Paix 75001 Paris
- Acheteur : CLIENT SA, 5 av. des Champs 69001 Lyon
- 10h de développement à 150€/h HT, TVA 20%
- Paiement à 30 jours, IBAN FR76...
Claude utilise automatiquement facturx_generate et retourne le XML Factur-X prêt à l'emploi.
Conformité
- Norme EN 16931 (directive européenne 2014/55/UE)
- Compatible Factur-X profils : MINIMUM, BASIC, EN_16931, EXTENDED
- Compatible ZUGFeRD 2.x (Allemagne)
- Prêt pour la réforme française e-facturation B2B (septembre 2026)
- Intégration Chorus Pro (facturation B2G)
Licence
MIT — © 2026 facturx-mcp
Tools (9)
facturx_generateGenerate a valid Factur-X XML invoice compliant with EN 16931.facturx_validateValidate invoice data before generation.facturx_parseParse an existing Factur-X XML file.facturx_compute_totalsCalculate HT, TVA, and TTC totals.facturx_create_pdfCreate a PDF with embedded XML.facturx_extract_from_pdfExtract XML data from a PDF file.chorus_submitSubmit an invoice to Chorus Pro (B2G).chorus_get_statusRetrieve the status of a CPP invoice.chorus_list_invoicesList invoices from Chorus Pro.Environment Variables
FACTURX_LICENSE_KEYPro license key (format FTRX-...)CHORUS_CLIENT_IDClient ID PISTE for Chorus ProCHORUS_CLIENT_SECRETClient Secret PISTE for Chorus ProCHORUS_LOGINLogin for technical Chorus Pro accountCHORUS_PASSWORDPassword for technical Chorus Pro accountCHORUS_SANDBOXSet to true for sandbox environmentConfiguration
claude_desktop_config.json
{"mcpServers": {"facturx": {"command": "facturx-mcp", "env": {"FACTURX_LICENSE_KEY": "FTRX-..."}}}}Try it
→Generate a Factur-X invoice for a service provided to ACME SAS with 10 hours of development at 150€/h.
→Validate the invoice data for my client before I generate the XML file.
→Parse this Factur-X XML file and summarize the total amount including taxes.
→Submit my latest invoice to Chorus Pro using my configured credentials.