Skip to main content

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.

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):

uvx hr-eli-mcp

Or from source:

cd hr-eli-mcp
pip install -e .

Configure (Claude Code / any MCP client)

{
  "mcpServers": {
    "hr-eli-mcp": { "command": "hr-eli-mcp" }
  }
}

Windows 11 ze Smart App Control

Smart App Control blokuje niepodpisane pliki wykonywalne, a uvx.exe, pip.exe i generowany przy instalacji hr-eli-mcp.exe podpisane nie sa. python.exe z python.org jest podpisany przez Python Software Foundation, wiec uruchomienie przez modul omija blokade:

python -m pip install hr-eli-mcp
python -m hr_eli_mcp
{ "mcpServers": { "hr-eli-mcp": { "command": "python", "args": ["-m", "hr_eli_mcp"] } } }

Nie wylaczaj Smart App Control, zeby to obejsc - wylaczenia nie da sie cofnac bez ponownej instalacji systemu.

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

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hr_eli_mcp-0.2.1.tar.gz (21.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hr_eli_mcp-0.2.1-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file hr_eli_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: hr_eli_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 21.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for hr_eli_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 bca592c794400935a102d426ec42ec82a88f8e35576e38146c34fd50e1e8097f
MD5 7a632b22b4418151e12d5743d732995d
BLAKE2b-256 740234de2aeb5df267db7a01841eb47e97930aa6673315502050cff8bb4f9d2c

See more details on using hashes here.

File details

Details for the file hr_eli_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: hr_eli_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for hr_eli_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8aee8e16df93ce17998d4ca4a87d67f5d2336e5d1ec6e4d31fcccfec8e41b27d
MD5 bcdc391aad66ad2d62f08a0fe3a5bce5
BLAKE2b-256 91436d1e7e9282b440688c9e9aa26618c0bbb5368b4d7ec558492e098a3459a9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page