{
  "markdown": "# nl-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/nl-eli-mcp -->\n\n\n## Install (one command)\n\nPublished on PyPI + MCP Registry (`io.github.matematicsolutions/nl-eli-mcp`). Run without cloning:\n\n```bash\nuvx nl-eli-mcp\n```\n\nConfigure your MCP client (stdio):\n\n```json\n{ \"mcpServers\": { \"nl-eli-mcp\": { \"command\": \"uvx\", \"args\": [\"nl-eli-mcp\"] } } }\n```\n\n### Windows 11 with Smart App Control\n\nSmart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`\nand the `nl-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 nl-eli-mcp\npython -m nl_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 nl_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"nl-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"nl_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\nBuilding from source: see [Install](#install).\n\nAn MCP server for the **Dutch consolidated legislation BWB** (Basiswettenbestand), served by\nKOOP over the official SRU API (`zoekservice.overheid.nl`, keyless). It gives an AI agent the\nversion of an act **in force on a given date**, with a verifiable citation: a persistent\nidentifier, a human-readable citation, and a link to the official source.\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.** The Netherlands does **not** publish native ELI (`/eli/`) URIs on consolidated\n> BWB. To keep the line's contract honest, `eli_uri` carries the official persistent\n> identifier instead — the `wetten.overheid.nl/id` *toestand* URI\n> (e.g. `http://wetten.overheid.nl/id/BWBR0005537/2026-06-04/0`). The connector never\n> fabricates an `/eli/` URI and says so in its tool instructions. See `DISCOVERY.md`.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `nl_search(query, on_date=today)` | Find acts by words in the title that are in force on a date. Returns distinct acts, each with the citation contract. |\n| `nl_get_act(bwb_id, on_date=today)` | Metadata for one act (e.g. `BWBR0005537`) — identifier, title, authority, version date. |\n| `nl_get_text(bwb_id, on_date=today)` | The full consolidated XML (BWB *toestand*) of one act. |\n| `nl_case_search(date_from, date_to, ...)` | List court decisions (Rechtspraak Open Data) by date range / court / subject. No free-text; each hit carries a native `ecli`. |\n| `nl_get_decision(ecli)` | A court decision by its ECLI (e.g. `ECLI:NL:HR:2020:1`) — court, dates, zaaknummer and full text. |\n| `nl_coverage()` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |\n\nLegislation comes from the **BWB** (KOOP SRU); case law comes from **Rechtspraak Open Data**\n(`data.rechtspraak.nl`), keyed by native ECLI. Every response carries the **citation contract**:\n\n- `eli_uri` — the official persistent identifier (toestand URI; see the ELI note above).\n- `human_readable_citation` — the official short title (citeertitel), e.g. *Algemene wet bestuursrecht*.\n- `source_url` — the browsable `wetten.overheid.nl` page for that version.\n\n### Versions and dates\n\nEach act has many time-stamped versions. The tools default to the version **in force today**;\npass `on_date` (`YYYY-MM-DD`) to pin a historical or future version. An act with no version\nvalid on that date returns `not_found` — retry with another `on_date`.\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    \"nl-eli-mcp\": {\n      \"command\": \"nl-eli-mcp\",\n      \"env\": {\n        \"NL_ELI_BASE_URL\": \"https://zoekservice.overheid.nl/sru/Search\",\n        \"NL_ELI_CACHE_DIR\": \"~/.matematic/cache/nl-eli\",\n        \"NL_ELI_AUDIT_DIR\": \"~/.matematic/audit\"\n      }\n    }\n  }\n}\n```\n\n## Design\n\n- **Public data only.** Read-only against the keyless KOOP SRU API and the official repository\n  host; nothing is sent beyond the query / identifier and the date.\n- **Audit log.** Every call appends one JSON line to `~/.matematic/audit/nl-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.** Identifiers and titles are parsed from the source record. If KOOP's\n  schema changes, the connector fails loudly rather than returning stale or invented data.\n\nSee `CONSTITUTION.md` (the 4 principles) and `DISCOVERY.md` (how the source was mapped).\n\n## Tests\n\n```bash\npytest tests/test_instructions_drift.py tests/test_parse.py   # offline\npytest tests/test_smoke.py                                     # live KOOP API\n```\n\n## Licence\n\nApache-2.0. The Dutch legislation served is official public data of the Kingdom of the\nNetherlands; this connector adds no rights over it.\n",
  "bytes": 5147,
  "sha": "6e1521d5e4ca5d4b9225449e526e58ddc12da19c50352b0b1bfda5c01ec4d26a",
  "repo_slug": "matematicsolutions/nl-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_nl_eli_mcp_466c5aa8/readme"
}