{
  "markdown": "# hu-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/hu-eli-mcp -->\n\nAn MCP server for **Hungary's official national legislation database**, the Nemzeti\nJogszabalytar (NJT, `njt.jog.gov.hu`), maintained by MKIFK. It gives an AI agent a piece of\nHungarian legislation resolved by its **native ELI** (European Legislation Identifier), with a\nverifiable citation: the ELI itself, a human-readable citation, and a link to the official\nsource.\n\nPart of the **eu-legal-mcp** line by [MateMatic](https://matematic.co) — one connector per EU\nmember state, the same citation contract everywhere.\n\n> **On ELI.** Unlike the Netherlands and Sweden (earlier connectors in this line, neither of\n> which publishes native ELI), **Hungary has a genuine, documented national ELI\n> implementation since 2023** (`njt.jog.gov.hu/eli/urisemak`). `eli_uri` is therefore the real\n> `/eli/` URI the tool resolved — never a substitute identifier. See `DISCOVERY.md`.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `hu_get_act(year, serial)` | Metadata for a Hungarian Act (torveny) by ELI, e.g. year `2013`, serial `5` (the Civil Code). No issuer code needed. |\n| `hu_get_legislation(doc_type, year, issuer, serial)` | Metadata for any other legislation (decrees etc.) by ELI — type, year, issuer (case-sensitive) and serial. |\n| `hu_get_text(doc_type, year, serial, issuer=None)` | The full document HTML content for either an Act or other legislation. |\n| `hu_list_doc_types()` | Valid NJT document-type codes (e.g. `TV`=Act, `R`=decree). |\n| `hu_list_issuers()` | Valid NJT issuer codes (e.g. `Korm`=Government) — note the exact casing matters. |\n| `hu_coverage()` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |\n\nEvery response carries the **citation contract**:\n\n- `eli_uri` — the native ELI URI resolved, e.g. `https://njt.jog.gov.hu/eli/TV/2013/5`.\n- `human_readable_citation` — built from the parsed title + subtitle, e.g.\n  *\"2013. évi V. törvény (a Polgári Törvénykönyvről)\"*.\n- `source_url` — the browsable `njt.jog.gov.hu/jogszabaly/...` document page.\n\n### No free-text search\n\nNJT has no REST/JSON API and its search/browse UI is a JavaScript SPA requiring a session\n(not usable headlessly). Documents must be addressed by a **known ELI** — use\n`hu_list_doc_types` / `hu_list_issuers` to discover valid codes, then `hu_get_act` /\n`hu_get_legislation`. An unresolvable ELI (wrong year/serial/issuer, or wrong issuer-code\ncase) surfaces as `not_found` — NJT itself redirects it to a search-assist page rather than\na 404.\n\n## Install\n\n```bash\npip install -e \".[dev]\"\n```\n\nRegister it with your MCP client (see `.mcp.json.example`):\n\n```json\n{\n  \"mcpServers\": {\n    \"hu-eli-mcp\": {\n      \"command\": \"hu-eli-mcp\",\n      \"env\": {\n        \"HU_ELI_BASE_URL\": \"https://njt.jog.gov.hu\",\n        \"HU_ELI_CACHE_DIR\": \"~/.matematic/cache/hu-eli\",\n        \"HU_ELI_AUDIT_DIR\": \"~/.matematic/audit\"\n      }\n    }\n  }\n}\n```\n\n### Windows 11 with Smart App Control\n\nSmart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`\nand the `hu-eli-mcp.exe` launcher that pip writes at install time. The `python.exe` and\n`py.exe` from the python.org installer are signed by the Python Software\nFoundation, so running the module through the interpreter works:\n\n```bash\npython -m pip install hu-eli-mcp\npython -m hu_eli_mcp\n```\n\n`pip.exe` is blocked for the same reason, so install with `python -m pip`, not\n`pip install`. If `python` is not on PATH, use the Windows launcher: `py -3 -m hu_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"hu-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"hu_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\n## Design\n\n- **Public data only.** Read-only against the keyless, official `njt.jog.gov.hu`; nothing is\n  sent beyond the ELI path being resolved. Honors `robots.txt` (never calls `/search/*`).\n- **Audit log.** Every call appends one JSON line to `~/.matematic/audit/hu-eli-mcp.jsonl`\n  (AI Act art. 12 record-keeping).\n- **Vendor-neutral.** No LLM provider, no telemetry; own backoff + on-disk cache.\n- **No fabrication.** The ELI, title and citation are parsed from the resolved document page.\n  If NJT's markup changes, the connector fails loudly rather than returning stale or invented\n  data.\n\nSee `CONSTITUTION.md` (the 4 principles) and `DISCOVERY.md` (how the source was mapped,\nincluding the `njt.hu` → `njt.jog.gov.hu` domain discovery and the issuer-code casing gotcha).\n\n## Tests\n\n```bash\npytest tests/test_instructions_drift.py   # offline\npytest tests/test_smoke.py                 # live NJT\n```\n\n## Licence\n\nApache-2.0. The Hungarian legislation served is official public data of Hungary; this\nconnector adds no rights over it.\n",
  "bytes": 4841,
  "sha": "175ffb15f4b911b73d11cd66b07cf372ab9869e1981c9db88d6511ccb231ba27",
  "repo_slug": "matematicsolutions/hu-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_hu_eli_mcp_fc9ce9dd/readme"
}