# Poland Invoice MCP

> A remote MCP server that lets any AI agent issue Poland structured e-invoices (faktura ustrukturyzowana, schema FA(3)) through KSeF 2.0 — Krajowy System e-Faktur, the Ministry of Finance national e-invoice API. Create and query invoices by KSeF number. Stateless, bring-your-own credentials, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-pl.wishpool.app/mcp
- Credentials headers: x-ksef-token (a KSeF authorization token you self-mint in the MoF taxpayer portal, ksef.podatki.gov.pl) + x-ksef-nip (your 10-digit seller NIP). Your KSeF certificate stays with the Ministry of Finance.
- Mode header: x-ksef-mode: production submits real invoices to KSeF; demo = demo env; omitted = TEST env (no fiscal effect, the safe default).
- Flow: create_invoice builds an FA(3) invoice, authenticates (RSA-OAEP challenge handshake), opens an AES-256 encrypted online session, submits, and returns the KSeF number (numer KSeF) -> query_invoice with that number confirms it is in the national repository.
- Amounts in PLN. Each line item has a NET unit price + a Polish VAT rate (23, 8, 5, or 0). Per-rate net/VAT and the invoice gross total are computed for you. The seller NIP comes from the x-ksef-nip header (not the body).
- No cancel: KSeF has no void operation — corrections are separate documents (faktura korygująca, RodzajFaktury=KOR). Hence two tools only.

## Tools

- create_invoice: Issue an FA(3) structured e-invoice — seller_name, buyer_nip + buyer_name, invoice_number, items (name, quantity, net_price, vat_rate) in, KSeF number out. Buyer NIP validated with the official checksum.
- query_invoice: Fetch an invoice by its KSeF number — status ACCEPTED (present in the national KSeF repository under your NIP = fiscal proof).
- Owner policy guardrails: x-agentpay-max-amount (hard cap on invoice gross total, PLN), x-agentpay-approval-above (returns an unsigned draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them.

## Safety

Stateless translation layer straight to the government KSeF API. The KSeF certification and the taxpayer certificate stay with the Ministry of Finance; the merchant's KSeF token and NIP travel per-request in headers. This server never stores credentials, invoices, or customer data. Privacy policy: https://inv-pl.wishpool.app/privacy

## Sister servers

Invoices: Mexico CFDI 4.0 https://inv-mx.wishpool.app/mcp, Chile DTE https://inv-cl.wishpool.app/mcp, Brazil NF-e https://inv-br.wishpool.app/mcp, Peru CPE https://inv-pe.wishpool.app/mcp, India GST e-invoicing https://inv-in.wishpool.app/mcp. Same stateless BYO pattern, local payments in 81 countries — full list: https://mcp.wishpool.app/llms.txt (Taiwan e-invoice 電子發票 lives in https://mcp.wishpool.app/mcp).