tezga-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Samo za remote (`start:http`). | 8787 |
| MCP_PATH | No | Putanja remote endpointa. | /mcp |
| TEZGA_API_KEY | Yes | Obavezno. Ključ `tzg_...` iz Podešavanja → Integracije. | |
| TEZGA_BASE_URL | No | Bazni URL API-ja. | https://pos.narbiz.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tezga_okruzenjeA | Vraća okruženje naloga (produkcija, sandbox ili simulacija) i poreske oznake. Pozovi OVO prvo da znaš da li bi izdavanje računa napravilo pravi račun kod Poreske uprave. |
| tezga_izdaj_racunA | Izdaje i fiskalizuje račun preko V-PFR-a i vraća PFR broj, QR, verifikacioni URL i javni PDF link. Idempotentno: isti externalId nikad ne pravi drugi račun. U produkciji traži potvrdiProdukciju=true. |
| tezga_storno_ili_refundacijaA | vrsta=storno poništava ceo račun (pogrešno izdat, bez podataka kupca). vrsta=refundacija vraća novac, celu ili po stavkama. Original se nalazi po documentId ili po externalId. U produkciji traži potvrdiProdukciju=true. |
| tezga_avansA | Otvara avansni račun (iznos, datumUplate, stopa, kupac). Sa zatvori=true i stvarnim stavkama izdaje refundaciju avansa pa konačni račun. U produkciji traži potvrdiProdukciju=true. |
| tezga_stanje_dokumentaB | Vraća sve fiskalne podatke dokumenta (PFR broj, verifikacioni URL, status) po Tezga ID-ju. |
| tezga_lista_dokumenataB | Lista fiskalnih dokumenata naloga, sa opcionim filterima (prosleđuju se kao query parametri). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool maps to a distinct step in the fiscalization lifecycle (environment check, issue, storno/refund, advance, single-document status, document listing). The only mild overlap is between tezga_stanje_dokumenta (one document by ID) and tezga_lista_dokumenata (filtered listing), and between tezga_izdaj_racun and tezga_avans, but the descriptions make the boundaries clear. The combined storno/refund tool bundles two actions, though its vrsta parameter disambiguates them.
All names share a consistent tezga_ snake_case prefix, which aids grouping. However, the stems mix verb phrases (izdaj_racun) with bare noun phrases (okruzenje, avans, stanje_dokumenta, lista_dokumenata), and one name is a compound with 'ili' (storno_ili_refundacija), so the pattern is readable but not uniform.
Six tools is well-scoped for an invoicing/fiscalization server: one per major operation plus a listing and a status lookup. No tool feels redundant or like padding.
The surface covers the full core lifecycle: environment check, invoice issuance, storno/refund, advance invoices, status retrieval and document listing, with idempotency and production confirmation handled. Minor gaps exist — no direct document lookup by externalId or a dedicated PDF/QR retrieval tool (links are only returned at issue time).