Hungary Invoice
About
Hungary Invoice MCP đđș â How can my AI agent report an invoice to NAV Online SzĂĄmla (szĂĄmla adatszolgĂĄltatĂĄs)?
Details
- Author
- junter1989k-ai
- Downloads
- 267
Jump to
- HUF only. Foreign-currency invoices (with exchangeRate) are not supported yet
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hungary InvoiceCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The README includes setup instructions such as node test/serve.js # local server on :3243.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hungary invoice": {
"hungary-invoice": {
"type": "http",
"url": "https://inv-hu.wishpool.app/mcp",
"headers": {
"x-nav-login": "your_technical_user",
"x-nav-password": "your_password_value",
"x-nav-signkey": "your_signkey_material",
"x-nav-exchangekey": "your_exchangekey_material",
"x-nav-taxnumber": "12345678"
}
}
}
}
}McpServers
{
"hungary-invoice": {
"type": "http",
"url": "https://inv-hu.wishpool.app/mcp",
"headers": {
"x-nav-login": "your_technical_user",
"x-nav-password": "your_password_value",
"x-nav-signkey": "your_signkey_material",
"x-nav-exchangekey": "your_exchangekey_material",
"x-nav-taxnumber": "12345678"
}
}
}Hungary Invoice MCP đđș â How can my AI agent report an invoice to NAV Online SzĂĄmla (szĂĄmla adatszolgĂĄltatĂĄs)?
Remote MCP server that lets any AI agent report Hungary invoice data to NAV Online SzĂĄmla 3.0 â the Hungarian tax authority's national invoice-data reporting API (szĂĄmla adatszolgĂĄltatĂĄs). It builds the InvoiceData XML, runs the signed token-exchange + manageInvoice flow, and returns the government transactionId. Stateless, bring-your-own credentials, never stores anything.
> This is reporting, not issuing. NAV Online SzĂĄmla is a data-reporting system: the merchant issues the actual invoice to the buyer with their own invoicing software, and â as required by Hungarian law â reports the invoice data to NAV. This server does that reporting step; it does not deliver invoices to buyers.
Live endpoint: https://inv-hu.wishpool.app/mcp · Registry: app.wishpool/hungary-invoice-mcp
Quick start
{
"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.
Tools
| Tool | What it does |
|---|---|
| submit_invoice | Report an invoice to NAV â supplier_name, customer_name (+ optional customer_tax_number for B2B), invoice_number, items (name, quantity, unit_net_price, vat_rate 27/18/5/0) in, transactionId out. Supplier tax number comes from the header; per-rate net/VAT and the gross total are computed for you (HUF). Omit customer_tax_number for a private person. |
| query_transaction | Read the NAV processing status by transactionId: RECEIVED / PROCESSING / SAVED / DONE (success terminal) / ABORTED (rejected â see validation_messages). |
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. The cap applies to the invoice gross total (HUF).
Scope & honest gaps
- CREATE only in v0.1. Correcting or cancelling a reported invoice (MODIFY / STORNO operations) is a separate reporting flow kept out of this version to stay focused. To correct a mistake, issue a modifying/cancelling invoice to the buyer and report it.
- HUF only. Foreign-currency invoices (with exchangeRate) are not supported yet.
- Domestic B2B / private person. customerVatStatus is DOMESTIC (with buyer tax number) or PRIVATE_PERSON (without). OTHER (foreign) buyers and special cases (margin scheme, reverse charge, EKĂER, product codes) are out of scope for v0.1.
How it works (NAV Online SzĂĄmla 3.0 flow)
1. Token exchange: POST /tokenExchange â sign the request with SHA3-512 over requestId + timestamp(yyyyMMddHHmmss) + signKey, hash the password with SHA-512; NAV returns encodedExchangeToken, which we AES-128-ECB decrypt with your exchange key.
2. Report: build the InvoiceData XML (namespace schemas.nav.gov.hu/OSA/3.0/data), base64 it, and POST /manageInvoice with a CREATE operation. The manageInvoice signature is index-chained: SHA3-512( requestId + timestamp + signKey + SHA3-512(operation + base64data) ). NAV returns a transactionId.
3. Status: POST /queryTransactionStatus with that transactionId returns the per-invoice invoiceStatus and any technical/business validation messages.
The password hash, request signature and token decryption all happen in memory per-request; nothing is embedded or stored.
Develop
node test/serve.js # local server on :3243
node test/e2e.js # protocol + validation + ĂFA-math + signature test vectors + LIVE probe against api-test.onlineszamla.nav.gov.hu
The e2e suite asserts the signature algorithm against fixed test vectors (fixed input â fixed SHA3-512 / SHA-512 / AES-128 output) and makes a real call to the government NAV test API: a well-formed tokenExchange with placeholder credentials runs the full SHA3-512 signing path and surfaces NAV's native INVALID_SECURITY_USER error â the deepest verification possible without a portal-minted technical user.
Safety
Pure stateless translation layer straight to the government NAV API. The NAV registration and tax context stay with the merchant; credentials travel per-request in headers, nothing is stored or logged. Privacy policy.
Sister servers
National e-invoices: Poland KSeF 2.0 inv-pl · Mexico CFDI 4.0 inv-mx · Chile DTE inv-cl · Brazil NF-e inv-br · Local payments in 81 countries, one family: mcp.wishpool.app · Taiwan e-invoice é»ćçŒç„š included.
MIT licensed.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
