🇭🇺 Hungary Invoice MCP live

AI agents can now report a Hungary invoice to NAV Online Számla (számla adatszolgáltatás). This remote MCP server talks directly to NAV Online Számla 3.0 — the Hungarian tax authority's national invoice-data reporting API — building the InvoiceData XML, signing it (SHA3-512), and returning the government transactionId. Two tools: submit_invoice, query_transaction.

Reporting, not issuing: the merchant issues the actual invoice to the buyer; this tool submits the invoice data to NAV as required by law.

Connect

{
  "mcpServers": {
    "hungary-invoice": {
      "type": "http",
      "url": "https://inv-hu.wishpool.app/mcp",
      "headers": {
        "x-nav-login": "your-technical-user-login",
        "x-nav-password": "your-technical-user-password",
        "x-nav-signkey": "your-signature-key",
        "x-nav-exchangekey": "your-16-byte-exchange-key",
        "x-nav-taxnumber": "12345678",
        "x-nav-mode": "prod"
      }
    }
  }
}

Self-mint all five keys as a technical user in the Online Számla web portal (onlineszamla.nav.gov.hu → Technical users). Omit x-nav-mode to stay in the NAV TEST environment (no legal effect). Your keys stay with you — this server never stores them.

How it works

• InvoiceData 3.0: schema namespace schemas.nav.gov.hu/OSA/3.0/data — supplier/customer tax numbers, names, addresses, line items and per-rate summary.
• Signed handshake: the server hashes your password (SHA-512), signs each request (SHA3-512 over requestId + timestamp + signKey, and an index-chained hash for manageInvoice), exchanges a token (AES-128 decrypted) and submits a CREATE operation.
• ÁFA computed for you: each line carries a NET price and a Hungarian ÁFA rate (27 / 18 / 5 / 0); per-rate net/VAT and the invoice gross total (invoiceGrossAmount) are computed in HUF.
• Async status: submit returns a transactionId; query_transaction reads RECEIVED / PROCESSING / SAVED / DONE / ABORTED plus validation messages.

Why it is safe

• Stateless: no database — your five technical-user keys travel per-request in headers and are never stored or logged.
• National API, no middleman: the report goes straight to the government NAV Online Számla system.
• 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 (HUF).

Weak-model friendly

Supplier tax number 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 (tax-number shape, ÁFA rate, mode, all five credential headers).

Sister servers

National e-invoices: Poland KSeF inv-pl · Mexico CFDI 4.0 inv-mx · Chile DTE inv-cl · Brazil NF-e inv-br. Local payments in 81 countries, one family, same stateless pattern: mcp.wishpool.app (Taiwan e-invoice 電子發票 included).