app.wishpool/italy-invoice-mcp — MCP Server for Italy FatturaPA Invoices

This MCP server helps AI agents issue Italy FatturaPA electronic invoices. It builds FPR12 XML, transmits the invoice to the SdI, and supports querying status. The server is exposed via an HTTP endpoint and is intended for MCP-capable clients.

🛠️ Key Features

Build FPR12 XML for FatturaPA invoices
Transmit invoices to SdI
Query invoice status
Accessible as an HTTP MCP server (https://inv-it.wishpool.app/mcp)

🚀 Use Cases

AI agents that need to create and send Italy e-invoices
Workflow automation around tax/invoice submission and delivery tracking

⚡ Developer Benefits

Integrates with MCP-capable agents (e.g., Claude Desktop, Cursor, Windsurf)
Credentials (when needed) are sent as HTTP headers per request and are not stored
Exposes an MCP server under the slug app-wishpool-italy-invoice-mcp

⚠️ Limitations

Tooling is focused on invoice issuance (FPR12 XML), SdI transmission, and status queries (2 tools total)

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

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "italy-invoice": {
      "type": "http",
      "url": "https://inv-it.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/italy-invoice-mcp && cd italy-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

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

json

{
  "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

Tool	What it does
`create_invoice`	Build a FatturaPA FPR12 invoice from seller + buyer (P.IVA / Codice Fiscale, address) and line items (description, net unit price, IVA rate 22/10/5/4, quantity), then transmit to the SdI via Invoicetronic. Returns `send_id` + computed IVA totals (`imponibile`, `imposta`, `totale`).
`query_invoice`	Poll SdI status by `send_id`: `SENT` (Inviato), `DELIVERED` (Consegnato), `REJECTED` (Scartato), `NOT_DELIVERED` (ImpossibilitaDiRecapito), or `PROCESSING` (no notification yet).

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

bash

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.

seller_name	string	required	Seller legal name / denominazione (CedentePrestatore).
seller_vat	string	required	Seller Partita IVA (P.IVA), 11 digits, e.g. 12345678903. IT prefix optional.
seller_tax_code	string	optional	Optional seller Codice Fiscale (11 digits for companies or 16 chars for individuals).
seller_address	string	required	Seller street address (Sede/Indirizzo).
seller_cap	string	required	Seller postal code / CAP, 5 digits.
seller_city	string	required	Seller city / Comune.
seller_province	string	optional	Optional seller province, 2-letter code (e.g. MI, RM).
seller_regime	string	optional	Seller tax regime code (RegimeFiscale). Default RF01 (ordinario). Others: RF19 (forfettario), etc.
customer_name	string	required	Buyer legal name / denominazione (CessionarioCommittente).
customer_vat	string	optional	Buyer Partita IVA (P.IVA), 11 digits. Provide this and/or customer_tax_code.
customer_tax_code	string	optional	Buyer Codice Fiscale (16 chars for individuals, 11 digits for companies). Provide this and/or customer_vat.
customer_address	string	required	Buyer street address (Sede/Indirizzo).
customer_cap	string	required	Buyer postal code / CAP, 5 digits.
customer_city	string	required	Buyer city / Comune.
customer_province	string	optional	Optional buyer province, 2-letter code.
customer_country	string	optional	Buyer country code (Nazione). Default IT.
codice_destinatario	string	optional	Recipient SdI Codice Destinatario, 7 chars. Default 0000000 (recipient retrieves from the tax drawer / cassetto fiscale, or set pec_destinatario).
pec_destinatario	string	optional	Optional recipient PEC email — used when codice_destinatario is 0000000 to route the invoice by certified email.
invoice_number	string	optional	Invoice number (Numero). Auto-generated if omitted.
issue_date	string	optional	Invoice date (Data), YYYY-MM-DD. Default: today (UTC).
document_type	string	optional	FatturaPA TipoDocumento. Default TD01 (fattura). Use TD04 for a credit note (nota di credito).
currency	string	optional	Document currency (Divisa). Default EUR.
lines	array	required	Invoice line items. Each: description, unit_price (net, IVA-exclusive, EUR), vat_rate (22\|10\|5\|4), optional quantity (default 1).

Italy Invoices (FatturaPA / SdI via Invoicetronic)