Croatian Law MCP

A Model Context Protocol (MCP) server providing access to Croatian legislation covering data protection, cybersecurity, e-commerce, and criminal law provisions.

MCP Registry: eu.ansvar/croatian-law-mcp npm: @ansvar/croatian-law-mcp

Quick Start

Claude Desktop / Cursor (stdio)

{
  "mcpServers": {
    "croatian-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/croatian-law-mcp"]
    }
  }
}

Remote (Streamable HTTP)

croatian-law-mcp.vercel.app/mcp

Data Sources

Full provenance: sources.yml

Real Ingestion (Open Method)

This repository uses an explicit, auditable ingestion pipeline from official Narodne novine endpoints.

Why this approach

The earlier catalog approach discovered laws by calling per-act API metadata, which is correct but slow. The current default method builds the catalog much faster from yearly official index files, then ingests full text law-by-law.

Official endpoints used

• Yearly index (CSV/XLSX): https://narodne-novine.nn.hr/get_index_file.aspx?year=YYYY&type=csv
• Law text (HTML print view): https://narodne-novine.nn.hr/eli/sluzbeni/{year}/{issue}/{act}/hrv/printhtml
• Optional metadata/verification: https://narodne-novine.nn.hr/api/* and ELI URLs

Selection and filtering rules

• Only eli/sluzbeni entries are cataloged (same scope as SL ingestion).
• A row is treated as law corpus when the document type contains zakon.
• ispravak correction notices are kept in catalog for transparency but skipped during ingest when they have no article structure.
• No legal text is fabricated; entries that cannot be parsed are reported as failed/skipped.

Rate limiting and compliance

• Requests to government servers are rate limited to 1 request/second (within the required 1-2s interval).
• Retries are performed only for transient HTTP errors (429/5xx) with exponential backoff.

Commands

# Fast catalog build from official yearly CSV indexes (1990..current year)
npm run catalog:build-csv

# Ingest only missing laws from catalog into data/seed-catalog
npm run catalog:ingest

# One-shot fast sync (catalog + ingest)
npm run catalog:sync-fast

catalog:ingest is incremental (only-new behavior) and safe to rerun.

Tools

License

Apache-2.0