{
  "markdown": "# hr-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/hr-eli-mcp -->\n\nAn MCP server for the Croatian **Narodne novine** official gazette (`narodne-novine.nn.hr`). It\nfetches Croatian legislation with European ELI identifiers and verifiable citations.\n\nPart of the MateMatic `eu-legal-mcp` production line - after PL, DE, AT, ES, FI, IE, NL, SE, FR,\nLU, DK and CZ. Same citation contract, Narodne novine source. Croatia is ELI-native on the\nEuropean ELI ontology (`data.europa.eu/eli`), with JSON-LD metadata per document.\n\n> **Scope.** This MVP lists the documents of a gazette issue, returns per-document metadata from\n> JSON-LD, and fetches the official HTML text. Documents are addressed by year + issue + document\n> number; the gazette is path-based, not keyword search. Coverage 1990-present. Language:\n> Croatian. Every response carries a `dataset_note`.\n>\n> **Licence.** Narodne novine is the official public gazette of Croatia. This connector relays it\n> read-only with attribution and a `source_url`.\n\n## The tools\n\n| Tool | What it does |\n|---|---|\n| `hr_list_issue` | List the documents of a gazette issue by year + issue (discovery). |\n| `hr_get_act` | Metadata for a document by year + issue + doc number. |\n| `hr_get_text` | Full official HTML text of a document. |\n| `hr_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 contract: `eli_uri` (the European ELI URL, e.g.\n`https://narodne-novine.nn.hr/eli/sluzbeni/2018/42/805`), `human_readable_citation`\n(title + `NN 42/2018`), and `source_url`.\n\n## Install\n\nRun it with no install step (once published to PyPI):\n\n```bash\nuvx hr-eli-mcp\n```\n\nOr from source:\n\n```bash\ncd hr-eli-mcp\npip install -e .\n```\n\n## Configure (Claude Code / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"hr-eli-mcp\": { \"command\": \"hr-eli-mcp\" }\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 `hr-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 hr-eli-mcp\npython -m hr_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 hr_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"hr-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"hr_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\nEnvironment:\n\n- `HR_ELI_BASE_URL` - default `https://narodne-novine.nn.hr`\n- `HR_ELI_CACHE_DIR` - default `~/.matematic/cache/hr-eli`\n- `HR_ELI_AUDIT_DIR` - default `~/.matematic/audit`\n\nNo API key. Narodne novine open data is keyless.\n\n## Governance\n\n- **Public data only** - read-only against Narodne novine; no client data leaves the machine.\n- **Audit log** - every tool call appends one JSON line to `~/.matematic/audit/hr-eli-mcp.jsonl`.\n- **Vendor-neutral** - talks only to `narodne-novine.nn.hr`; no LLM provider, no telemetry.\n- **Verifiable citations** - every response is independently checkable via `source_url`.\n\nSee `CONSTITUTION.md` and `DISCOVERY.md`.\n\n## Tests\n\n```bash\npip install -e \".[dev]\"\npytest tests/test_instructions_drift.py tests/test_parse.py -v   # offline\npytest tests/test_smoke.py -v                                    # hits live Narodne novine\n```\n\n## Licence\n\nApache-2.0. © Matematic Solutions / Wieslaw Mazur.\n",
  "bytes": 3679,
  "sha": "978370f880c0f194efc026e8538b1bc77f887e9812742dbc4caa9b09ff4a6e0f",
  "repo_slug": "matematicsolutions/hr-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_hr_eli_mcp_2fc6d08c/readme"
}