io.github.matematicsolutions/hr-eli-mcp
MCP server for Croatian legislation (Narodne novine) with European ELI and verifiable citations.
Open source Open in the app JSON README (API)
About
MCP server for Croatian legislation (Narodne novine) with European ELI and verifiable citations.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- matematicsolutions
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.3.3
- Last push
- 2026-08-24T13:56:12Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-29 04:00:29
- Updated
- 2026-08-29 04:00:29
- Origin id
io.github.matematicsolutions/hr-eli-mcp
README
# hr-eli-mcp
<!-- mcp-name: io.github.matematicsolutions/hr-eli-mcp -->
An MCP server for the Croatian **Narodne novine** official gazette (`narodne-novine.nn.hr`). It
fetches Croatian legislation with European ELI identifiers and verifiable citations.
Part of the MateMatic `eu-legal-mcp` production line - after PL, DE, AT, ES, FI, IE, NL, SE, FR,
LU, DK and CZ. Same citation contract, Narodne novine source. Croatia is ELI-native on the
European ELI ontology (`data.europa.eu/eli`), with JSON-LD metadata per document.
> **Scope.** This MVP lists the documents of a gazette issue, returns per-document metadata from
> JSON-LD, and fetches the official HTML text. Documents are addressed by year + issue + document
> number; the gazette is path-based, not keyword search. Coverage 1990-present. Language:
> Croatian. Every response carries a `dataset_note`.
>
> **Licence.** Narodne novine is the official public gazette of Croatia. This connector relays it
> read-only with attribution and a `source_url`.
## The tools
| Tool | What it does |
|---|---|
| `hr_list_issue` | List the documents of a gazette issue by year + issue (discovery). |
| `hr_get_act` | Metadata for a document by year + issue + doc number. |
| `hr_get_text` | Full official HTML text of a document. |
| `hr_coverage` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |
Every response carries the contract: `eli_uri` (the European ELI URL, e.g.
`https://narodne-novine.nn.hr/eli/sluzbeni/2018/42/805`), `human_readable_citation`
(title + `NN 42/2018`), and `source_url`.
## Install
Run it with no install step (once published to PyPI):
```bash
uvx hr-eli-mcp
```
Or from source:
```bash
cd hr-eli-mcp
pip install -e .
```
## Configure (Claude Code / any MCP client)
```json
{
"mcpServers": {
"hr-eli-mcp": { "command": "hr-eli-mcp" }
}
}
```
### Windows 11 with Smart App Control
Smart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`
and the `hr-eli-mcp.exe` launcher that pip writes at install time. The `python.exe` and
`py.exe` from the python.org installer are signed by the Python Software
Foundation, so running the module through the interpreter works:
```bash
python -m pip install hr-eli-mcp
python -m hr_eli_mcp
```
`pip.exe` is blocked for the same reason, so install with `python -m pip`, not
`pip install`. If `python` is not on PATH, use the Windows launcher: `py -3 -m hr_eli_mcp`.
```json
{ "mcpServers": { "hr-eli-mcp": { "command": "python", "args": ["-m", "hr_eli_mcp"] } } }
```
Do not turn Smart App Control off to work around this - it cannot be re-enabled
without reinstalling Windows.
Environment:
- `HR_ELI_BASE_URL` - default `https://narodne-novine.nn.hr`
- `HR_ELI_CACHE_DIR` - default `~/.matematic/cache/hr-eli`
- `HR_ELI_AUDIT_DIR` - default `~/.matematic/audit`
No API key. Narodne novine open data is keyless.
## Governance
- **Public data only** - read-only against Narodne novine; no client data leaves the machine.
- **Audit log** - every tool call appends one JSON line to `~/.matematic/audit/hr-eli-mcp.jsonl`.
- **Vendor-neutral** - talks only to `narodne-novine.nn.hr`; no LLM provider, no telemetry.
- **Verifiable citations** - every response is independently checkable via `source_url`.
See `CONSTITUTION.md` and `DISCOVERY.md`.
## Tests
```bash
pip install -e ".[dev]"
pytest tests/test_instructions_drift.py tests/test_parse.py -v # offline
pytest tests/test_smoke.py -v # hits live Narodne novine
```
## Licence
Apache-2.0. © Matematic Solutions / Wieslaw Mazur.