FatturaPA / SDI MCP server

fatturapa-mcp-server

<!-- mcp-name: io.github.MaurizioLisanti/fatturapa-mcp-server -->

English

The problem

Every project integrating FatturaPA reimplements the same validation, parsing and SDI error handling from scratch. The result: weeks of repeated work, hidden bugs and no standardization.

The solution

Seven AI tools installable in one line — document parsing, anomaly detection on received invoices, multi-invoice reporting, Italian and EU VAT verification via VIES, structural XML checks and offline SDI error lookup.

Status: beta. See Known limitations before

relying on validation results.

Who is it for

Python developers and AI teams working on Italian electronic invoicing systems who want to integrate Claude without reimplementing FatturaPA compliance from scratch on every project.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants seven ready-to-use tools for working with Italian electronic invoices (FatturaPA) and the SDI (Sistema di Interscambio) system — no plumbing required.

Tools

Quick start

Option A — uvx (no install required)

uvx fatturapa-mcp-server

Option B — pip

pip install fatturapa-mcp-server
fatturapa-mcp-server

Claude Desktop configuration

Add the following block to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "fatturapa": {
      "command": "uvx",
      "args": ["fatturapa-mcp-server"],
      "env": { "FATTURAPA_ALLOWED_ROOTS": "/path/to/your/invoices" }
    }
  }
}

FATTURAPAALLOWEDROOTS lists the only folders the server may read (: separated on macOS/Linux, ; on Windows). Without it every filepath read is refused and documents must be passed as xmlcontent. This is deliberate: the server is driven by an AI agent reading untrusted documents.

After restarting Claude Desktop you will see seven new tools in the tool panel.

Known limitations (v0.3.2)

Shortened. The full README is on GitHub.