# NAV Online Invoice - NAV online számla

Manage and query Hungarian invoice data directly through the National Tax and Customs Administration (NAV) system. Retrieve taxpayer information, verify invoice validity, and track transaction status…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add aiamindennapokban/nav-online-invoice-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list aiamindennapokban/nav-online-invoice-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get aiamindennapokban/nav-online-invoice-mcp query_taxpayer

# Call a tool
npx -y @smithery/cli@latest tool call aiamindennapokban/nav-online-invoice-mcp query_taxpayer '{}'
```

## Direct MCP Connection

Endpoint: `https://nav-online-invoice-mcp--aiamindennapokban.run.tools`

**Required config:**
- `NAV_LOGIN` (query) — NAV Online Invoice API login username
- `NAV_PASSWORD` (query) — NAV Online Invoice API password
- `NAV_TAX_NUMBER` (query) — 8-digit Hungarian tax number (adoszam)
- `NAV_SIGNATURE_KEY` (query) — NAV API XML signature key
- `NAV_EXCHANGE_KEY` (query) — NAV API data exchange key

**Optional config:**
- `NAV_ENV` (query) — NAV environment (test or production)
- `NAV_SOFTWARE_ID` (query) — Registered software ID at NAV
- `NAV_SOFTWARE_DEV_NAME` (query) — Software developer name
- `NAV_SOFTWARE_DEV_CONTACT` (query) — Software developer contact email
- `NAV_SOFTWARE_DEV_TAX_NUMBER` (query) — Software developer tax number

## Tools (9)

- `query_taxpayer` — Query taxpayer information from NAV by tax number (adoszam). Returns company name, address, VAT status.
- `query_invoice_data` — Get full invoice data by invoice number from NAV. Returns complete invoice details.
- `query_invoice_digest` — Search invoices in NAV with filters. Returns a paginated list of invoice summaries. Must provide either date range (dat…
- `query_invoice_check` — Check if an invoice exists in NAV system.
- `query_invoice_chain_digest` — Query the modification chain of an invoice (original + all modifications/stornos).
- `query_transaction_status` — Check the processing status of a previously submitted invoice transaction.
- `query_transaction_list` — List transactions within a date range.
- `manage_invoice` — Submit invoice data to NAV (create, modify, or storno). Handles token exchange automatically. The invoiceData must be B…
- `manage_annulment` — Submit technical annulment for invoices. Use this for correcting technical errors (wrong data, wrong invoice number, et…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get aiamindennapokban/nav-online-invoice-mcp <tool-name>
```

## Prompts (3)

- `search-invoices` (direction, dateFrom, dateTo) — Search for invoices issued or received within a date range
- `check-taxpayer` (taxNumber) — Look up a Hungarian taxpayer by their tax number
- `invoice-details` (invoiceNumber, direction) — Get complete details of a specific invoice