Italy Invoice MCP Server

Italy Invoice MCP 🇮🇹 — How can my AI agent issue a FatturaPA fattura elettronica in Italy?

Remote MCP server that lets any AI agent issue Italy FatturaPA electronic invoices (fattura elettronica) and transmit them to the national SdI (Sistema di Interscambio) via Invoicetronic. It builds FatturaPA FPR12 XML (Agenzia delle Entrate v1.2 schema) and sends it under the merchant's own Invoicetronic API key. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-it.wishpool.app/mcp · Registry: app.wishpool/italy-invoice-mcp

Quick start

{
  "mcpServers": {
    "italy-invoice": {
      "type": "http",
      "url": "https://inv-it.wishpool.app/mcp",
      "headers": {
        "x-invoicetronic-key": "ik_test_<your Invoicetronic key>"
      }
    }
  }
}

Sign up at invoicetronic.com for a free ik_test_ sandbox key (no fiscal effect). An ik_live_ key transmits real invoices to the SdI — the base URL is the same, the key prefix selects the environment. Authentication is HTTP Basic with the key as the username (empty password). Your key stays with you and travels per-request; this server never stores it.

Tools

Amounts are in EUR. Italian IVA rates: 22 (ordinaria), 10, 5, 4 (ridotte). Seller/buyer identified by Partita IVA and/or Codice Fiscale.

No cancel at the SdI level — to reverse an invoice you issue a credit note (nota di credito, TipoDocumento TD04) as a new invoice. Zero-rated / exempt IVA (needs a Natura code) is out of scope in v1.

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

IVA math (deterministic)

Per line PrezzoTotale = round2(quantity × unit_price); grouped by rate into DatiRiepilogo (ImponibileImporto, Imposta = round2(imponibile × rate / 100)); document total ImportoTotaleDocumento = imponibile + imposta. Examples:

• 100 + 50 both @22% → imponibile 150.00 / imposta 33.00 / totale 183.00
• 200 @22% + 100 @10% → imponibile 300.00 / imposta 54.00 (44 + 10) / totale 354.00
• 2×50 @22% + 3×10 @10% + 1×25 @4% → imponibile 155.00 / imposta 26.00 (22 + 3 + 1) / totale 181.00

Endpoints wrapped (Invoicetronic REST)

• Base: https://api.invoicetronic.com/v1 (single base URL; auth = HTTP Basic, username = API key, empty password)
• Send: POST /send — JSON { file_name, payload (base64 FatturaPA XML), encoding: "base64", meta_data } → { id, ... }
• Query: GET /update?send_id={id} — SdI notification history (state: Inviato / Consegnato / Scartato / ImpossibilitaDiRecapito)
• Pre-flight validation: POST /send may reply 422 Unprocessable Entity for a FatturaPA rule violation
• (Inbound GET /receive exists for received invoices; not wrapped as a tool in v1.)

Develop

node test/serve.js   # local server on :3234
node test/e2e.js     # IVA math + FatturaPA XML structure + protocol + validation + policy + fake-key live probe

Safety

Pure stateless translation layer over the Invoicetronic REST API (which wraps the national SdI). The API key travels per-request in a header, nothing is stored, and funds are never touched — this issues tax invoices, it does not move money. Privacy policy.

Sister servers

Local invoices, one family: Mexico CFDI (inv-mx) · Romania e-Factura (inv-ro) · Brazil NF-e (inv-br) · Chile DTE (inv-cl) · India GST (inv-in). Local payments in 81 countries: mcp.wishpool.app.

MIT licensed.