Serbia Invoice

Remote MCP server that lets any AI agent issue Serbia SEF eFaktura electronic invoices (elektronska faktura) into the national Ministry of Finance system. It builds UBL 2.1 SRB-CIUS XML (Serbia's CIUS of EN 16931) and uploads it under the merchant's own SEF API key. Stateless, bring-your-own credential, never stores anything.

Live endpoint: https://inv-rs.wishpool.app/mcp · Registry: app.wishpool/serbia-invoice-mcp

Quick start

{
  "mcpServers": {
    "serbia-invoice": {
      "type": "http",
      "url": "https://inv-rs.wishpool.app/mcp",
      "headers": {
        "x-sef-api-key": "<your SEF API key>"
      }
    }
  }
}

You generate the SEF API key yourself in the SEF portal under Settings → API management (Podešavanja → Upravljanje API). Requests default to the SEF demo rail (no fiscal effect); add x-sef-mode: prod for the live rail. Your key never reaches storage — it is forwarded per-request to SEF as the official ApiKey header.

Tools

Tool	What it does
create_invoice	Build a UBL 2.1 SRB-CIUS invoice from seller PIB + name, buyer PIB + name + address + lines (name, qty, net unit price, VAT rate 20/10/0) and upload to SEF eFaktura. Returns sales_invoice_id + computed VAT totals. Optional send_to_cir for budget/public-sector buyers.
query_invoice	Check SEF status by sales_invoice_id: NEW, SENDING, SENT, SEEN, APPROVED, APPROVED_WITH_RESERVATION, REJECTED, CANCELLED, STORNO, MISTAKE, OVERDUE, REMINDED, DELETED.
cancel_invoice	Cancel (Otkazivanje) a sales invoice you sent, by sales_invoice_id + cancel_comment, before the buyer accepts it.

Amounts are in RSD. You supply your own seller identity (supplier_pib + supplier_name) — SEF validates it against your API-key account. After the buyer APPROVES, cancellation is closed — corrections require a storno (credit) document (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.

Endpoints wrapped (SEF eFaktura publicApi REST)

• Base: DEMO https://demoefaktura.mfin.gov.rs · PROD https://efaktura.mfin.gov.rs (prefix /api/publicApi)
• Upload: POST /sales-invoice/ubl?requestId={unique}&sendToCir={true|false} (Content-Type application/xml, raw UBL body) → { InvoiceId, PurchaseInvoiceId }
• Status: GET /sales-invoice?invoiceId={id} → invoice record incl. Status
• Cancel: POST /sales-invoice/cancel?invoiceId={id}&cancelComment={text}
• Auth: header ApiKey (forwarded from x-sef-api-key)

Develop

node test/serve.js   # local server on :3238
node test/e2e.js     # protocol + validation + VAT math + UBL structure + fake-key live probes

Safety

Pure stateless translation layer over the national SEF eFaktura API. The API key stays with the merchant and travels per-request in a header; nothing is stored. Privacy policy.

Sister servers

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

MIT licensed.