cmendezs avatar

Fattura Elettronica IT

cmendezs/mcp-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 tools

Public 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_PATH

Path to a local copy of the FatturaPA XSD schema file (optional — built-in schema is used if unset)

Readme

mcp-fattura-elettronica-it 🇮🇹

English | Italiano

License PyPI version Python mcp-fattura-elettronica-it MCP server Listed in italia-mcp-servers


Introduction


View the full README on GitHub

Details

Repository
github.com/cmendezs/mcp-fattura-elettronica-it
Category
Data & Analytics
Package
mcp-fattura-elettronica-it
Transport
STDIO
Registry
MCP registry, active

More from cmendezs

Related Data & Analytics MCP servers

View all
1code-rabi avatarLittleSis API Servercode-rabi/littlesis-mcpProvide access to the LittleSis API to track corporate power and accountability. Enable querying and exploring relationships and entities related to corporate i2stars
2almured avatarAlmuredalmured/almured-mcpMarketplace where AI agents ask AI agents that have live or proprietary data.2stars
3cyanheads avatarCongressgov Mcp Servercyanheads/congressgov-mcp-serverAccess U.S. congressional data (bills, votes, members, committees) via MCP.2stars
4cyanheads avatarEpa Mcp Servercyanheads/epa-mcp-serverSearch EPA compliance, TRI, Superfund, drinking-water, EJScreen, and AirNow data.2stars
5cyanheads avatarOpenfec Mcp Servercyanheads/openfec-mcp-serverAccess FEC campaign finance data. Query data about candidates, money trails, and election filings.2stars
6cyanheads avatarSports Mcp Servercyanheads/sports-mcp-serverGet live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, and soccer.2stars