
Fattura Elettronica IT
A Python MCP server that handles Italian FatturaPA XML invoicing for the Sistema di Interscambio (SDI). It exposes 21 tools covering transmission headers, seller and buyer validation, document type codes TD01 through TD28, line items, VAT summary computation, payment terms, and XSD validation against the official Agenzia delle Entrate schema v1.6.1. You get withholding tax calculation for professional invoices, Partita IVA checksum validation, SDI filename generation, and full support for B2B, B2G, and cross-border scenarios. Everything runs locally with no external API calls. Reach for this when you need to generate or validate compliant Italian e-invoices inside Claude or Cursor without managing the SDI spec yourself.
- GitHub stars
- 2
- tools
- 37
- transport
- STDIO
- env var
- 1
- last updated
- Sep 12, 2026
Tools
37 toolsPublic tool metadata for what this MCP can expose to an agent.
build_transmission_headerBuild DatiTrasmissione block: ProgressivoInvio, CodiceDestinatario, PECDestinatario
Build DatiTrasmissione block: ProgressivoInvio, CodiceDestinatario, PECDestinatario
No parameter schema in public metadata yet.
validate_cedente_prestatoreValidate seller block: IdFiscaleIVA, optional Gruppo IVA member CodiceFiscale, Anagrafica, Sede, RegimeFiscale codes
Validate seller block: IdFiscaleIVA, optional Gruppo IVA member CodiceFiscale, Anagrafica, Sede, RegimeFiscale codes
No parameter schema in public metadata yet.
validate_cessionarioValidate buyer block: IdFiscaleIVA or CodiceFiscale, Sede (warns on the structural precondition of scarto code 00327 for Gruppo IVA)
Validate buyer block: IdFiscaleIVA or CodiceFiscale, Sede (warns on the structural precondition of scarto code 00327 for Gruppo IVA)
No parameter schema in public metadata yet.
get_regime_fiscale_codesReturn all valid RegimeFiscale codes with descriptions (RF01-RF19)
Return all valid RegimeFiscale codes with descriptions (RF01-RF19)
No parameter schema in public metadata yet.
validate_partita_ivaValidate Italian VAT number (Partita IVA) format and checksum (11 digits)
Validate Italian VAT number (Partita IVA) format and checksum (11 digits)
No parameter schema in public metadata yet.
generate_progressivo_invioGenerate a unique ProgressivoInvio identifier (max 10 alphanumeric chars)
Generate a unique ProgressivoInvio identifier (max 10 alphanumeric chars)
No parameter schema in public metadata yet.
lookup_codice_destinatarioReturn info about a CodiceDestinatario (6-char SDI code) or PEC address (300-code max per accredited channel, Specifiche Tecniche 1.9.1)
Return info about a CodiceDestinatario (6-char SDI code) or PEC address (300-code max per accredited channel, Specifiche Tecniche 1.9.1)
No parameter schema in public metadata yet.
build_dati_generaliBuild DatiGenerali block: TipoDocumento, Divisa, Data, Numero, Causale
Build DatiGenerali block: TipoDocumento, Divisa, Data, Numero, Causale
No parameter schema in public metadata yet.
get_tipo_documento_codesReturn all TD01-TD28 codes with descriptions and use cases (incl. cross-border)
Return all TD01-TD28 codes with descriptions and use cases (incl. cross-border)
No parameter schema in public metadata yet.
add_linea_dettaglioAdd a DettaglioLinee entry: NumeroLinea, Descrizione, Quantita, PrezzoUnitario, optional AltriDatiGestionali
Add a DettaglioLinee entry: NumeroLinea, Descrizione, Quantita, PrezzoUnitario, optional AltriDatiGestionali
No parameter schema in public metadata yet.
build_sport_worker_exemption_dato_gestionaleBuild the AltriDatiGestionali entry for the sport-worker IRPEF exemption (TipoDato='ESENZSPORT', Specifiche Tecniche 1.9.1)
Build the AltriDatiGestionali entry for the sport-worker IRPEF exemption (TipoDato='ESENZSPORT', Specifiche Tecniche 1.9.1)
No parameter schema in public metadata yet.
compute_totaliCompute DatiRiepilogo: imponibile, imposta, AliquotaIVA from line items
Compute DatiRiepilogo: imponibile, imposta, AliquotaIVA from line items
No parameter schema in public metadata yet.
get_natura_codesReturn all Natura codes (N1-N7 and sub-codes) for VAT exemption with legal references
Return all Natura codes (N1-N7 and sub-codes) for VAT exemption with legal references
No parameter schema in public metadata yet.
build_dati_pagamentoBuild DatiPagamento: CondizioniPagamento (TP01/02/03), ModalitaPagamento (MP01-MP23)
Build DatiPagamento: CondizioniPagamento (TP01/02/03), ModalitaPagamento (MP01-MP23)
No parameter schema in public metadata yet.
add_allegatoAttach a base64-encoded document to the Allegati block with name and format
Attach a base64-encoded document to the Allegati block with name and format
No parameter schema in public metadata yet.
generate_fattura_xmlGenerate a complete FatturaPA XML file from structured input data
Generate a complete FatturaPA XML file from structured input data
No parameter schema in public metadata yet.
validate_fattura_xsdValidate a FatturaPA XML string against the official XSD schema v1.2.3
Validate a FatturaPA XML string against the official XSD schema v1.2.3
No parameter schema in public metadata yet.
parse_fattura_xmlParse an existing FatturaPA XML string and return a structured JSON dict
Parse an existing FatturaPA XML string and return a structured JSON dict
No parameter schema in public metadata yet.
export_to_jsonExport a parsed FatturaPA structure to clean JSON format
Export a parsed FatturaPA structure to clean JSON format
No parameter schema in public metadata yet.
validate_partita_iva_formatValidate Partita IVA format and Luhn-like checksum (11-digit Italian VAT)
Validate Partita IVA format and Luhn-like checksum (11-digit Italian VAT)
No parameter schema in public metadata yet.
get_sdi_filenameGenerate the official SDI filename: IT{PartitaIVA}_{ProgressivoInvio}.xml
Generate the official SDI filename: IT{PartitaIVA}_{ProgressivoInvio}.xml
No parameter schema in public metadata yet.
check_ritenuta_accontoCheck and compute ritenuta d'acconto (withholding tax) for professional invoices
Check and compute ritenuta d'acconto (withholding tax) for professional invoices
No parameter schema in public metadata yet.
generate_fattura_semplificataGenerate a simplified invoice XML (TD07/TD08/TD09) using VFSM10 format
Generate a simplified invoice XML (TD07/TD08/TD09) using VFSM10 format
No parameter schema in public metadata yet.
validate_fattura_semplificata_xsdValidate a simplified invoice XML against the VFSM10 XSD v1.0.2
Validate a simplified invoice XML against the VFSM10 XSD v1.0.2
No parameter schema in public metadata yet.
parse_fattura_semplificata_xmlParse a simplified invoice XML into a structured dict
Parse a simplified invoice XML into a structured dict
No parameter schema in public metadata yet.
sign_fattura_xadesApply XAdES-BES enveloped XML signature (.xml). Requires PKCS#12 cert.
Apply XAdES-BES enveloped XML signature (.xml). Requires PKCS#12 cert.
No parameter schema in public metadata yet.
sign_fattura_cadesApply CAdES-BES CMS/PKCS#7 attached signature (.xml.p7m). Requires PKCS#12 cert.
Apply CAdES-BES CMS/PKCS#7 attached signature (.xml.p7m). Requires PKCS#12 cert.
No parameter schema in public metadata yet.
submit_to_sdiSubmit a signed invoice to SDI via SDICoop SOAP (mTLS)
Submit a signed invoice to SDI via SDICoop SOAP (mTLS)
No parameter schema in public metadata yet.
check_sdi_statusCheck submission status by IdentificativoSDI
Check submission status by IdentificativoSDI
No parameter schema in public metadata yet.
parse_sdi_notificationParse SDI notification XML (RC/NS/MC/NE/EC/SE/DT/MT/AT); known scarto codes (e.g. 00327, Gruppo IVA CodiceFiscale) include a supplementary reference_note
Parse SDI notification XML (RC/NS/MC/NE/EC/SE/DT/MT/AT); known scarto codes (e.g. 00327, Gruppo IVA CodiceFiscale) include a supplementary reference_note
No parameter schema in public metadata yet.
send_esito_committenteSend acceptance (EC01) or rejection (EC02) to SDI
Send acceptance (EC01) or rejection (EC02) to SDI
No parameter schema in public metadata yet.
get_sdi_channel_infoShow current SDI channel configuration
Show current SDI channel configuration
No parameter schema in public metadata yet.
archive_invoiceArchive a signed invoice with SHA-256 hash and 10-year retention
Archive a signed invoice with SHA-256 hash and 10-year retention
No parameter schema in public metadata yet.
retrieve_archived_invoiceRetrieve an archived document by ID
Retrieve an archived document by ID
No parameter schema in public metadata yet.
verify_archive_integrityVerify SHA-256 hash integrity of an archived document
Verify SHA-256 hash integrity of an archived document
No parameter schema in public metadata yet.
list_archived_invoicesList all archived invoices
List all archived invoices
No parameter schema in public metadata yet.
build_pacchetto_versamentoBuild a PdV ZIP archive for transfer to an AgID-accredited conservator
Build a PdV ZIP archive for transfer to an AgID-accredited conservator
No parameter schema in public metadata yet.
Sponsors
Configuration
FATTURA_XSD_PATHPath to a local copy of the FatturaPA XSD schema file (optional — built-in schema is used if unset)
Readme
Details
- Repository
- github.com/cmendezs/mcp-fattura-elettronica-it
- Category
- Data & Analytics
- Package
mcp-fattura-elettronica-it- Transport
- STDIO
- Registry
- MCP registry, active