🇵🇱 Poland Invoice MCP live

AI agents can now issue a Poland structured e-invoice (faktura ustrukturyzowana). This remote MCP server talks directly to KSeF 2.0 — Krajowy System e-Faktur, the Ministry of Finance national e-invoice API — building the FA(3) schema and returning the government KSeF number. Two tools: create_invoice, query_invoice.

Connect

{
  "mcpServers": {
    "poland-invoice": {
      "type": "http",
      "url": "https://inv-pl.wishpool.app/mcp",
      "headers": {
        "x-ksef-token": "your-ksef-authorization-token",
        "x-ksef-nip": "1234567890",
        "x-ksef-mode": "production"
      }
    }
  }
}

Self-mint your x-ksef-token in the Ministry of Finance taxpayer portal (ksef.podatki.gov.pl → Tokeny / Uwierzytelnianie). Omit x-ksef-mode to stay in the MoF TEST environment (no fiscal effect). Your KSeF certificate stays with the Ministry of Finance; this server never sees it.

How it works

• FA(3) e-invoice: schema FA (3), version 1-0E, namespace crd.gov.pl/wzor/2025/06/25/13775 — mandatory in KSeF from 2026-02-01.
• Encrypted online session: the server authenticates with your KSeF token (RSA-OAEP challenge handshake), opens an AES-256 encrypted session, submits the invoice, and reads the assigned KSeF number.
• VAT computed for you: each line carries a NET price and a Polish VAT rate (23 / 8 / 5 / 0); per-rate net/VAT and the invoice gross total are computed and placed in the KSeF summary fields (P_13_1/P_14_1 …, P_15).
• No cancel: KSeF corrections are separate documents (faktura korygująca, KOR) — see FAQ.

Why it is safe

• Stateless: no database — your KSeF token and NIP travel per-request in headers and are never stored.
• National API, no middleman: the invoice goes straight to the government KSeF system; certification and the taxpayer certificate stay with the Ministry of Finance.
• Owner policy guardrails: 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. The cap applies to the invoice gross total (PLN).

Weak-model friendly

Seller NIP taken from the credential header (you never pass it in the body); status enums in the query description; every result embeds numbered next_steps; every error teaches the fix (NIP checksum, VAT rate, mode, both credential headers).

Sister servers

Invoices: Mexico CFDI 4.0 inv-mx · Chile DTE inv-cl · Brazil NF-e inv-br · Peru CPE inv-pe · India GST inv-in. Local payments in 81 countries, one family, same stateless pattern: mcp.wishpool.app (Taiwan e-invoice 電子發票 included).