Skip to main content

de-eli-mcp

Install (one command)

Published on PyPI + MCP Registry (io.github.matematicsolutions/de-eli-mcp). Run without cloning:

uvx de-eli-mcp

Configure your MCP client (stdio):

{ "mcpServers": { "de-eli-mcp": { "command": "uvx", "args": ["de-eli-mcp"] } } }

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the de-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:

python -m pip install de-eli-mcp
python -m de_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 de_eli_mcp.

{ "mcpServers": { "de-eli-mcp": { "command": "python", "args": ["-m", "de_eli_mcp"] } } }

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Building from source: see Install.

An MCP server for German law: NeuRIS (rechtsinformationen.bund.de) for federal legislation, three case-law sources - NeuRIS's beta case-law slice, the complete federal-courts aggregator rechtsprechung-im-internet.de (RII, official BMJ/juris portal) for BVerfG, BGH, BAG, BFH, BVerwG, BSG (+ BPatG), and Open Legal Data (de.openlegaldata.io, ~424k decisions from ~1 100 courts of ALL levels, including the state courts of all 16 Laender, with full-text search) - plus the Bundestag's DIP (dip.bundestag.de) for parliamentary documents and legislative history (~287k Drucksachen with full text, plenary transcripts, ~335k legislative procedures, Bundestag AND Bundesrat).

Part of the MateMatic eu-legal-mcp production line: the German counterpart of the Polish sejm-eli-mcp, built on the same architecture and citation contract against the German source.

Beta source (legislation + de_case_search). NeuRIS is an official but beta service; its dataset is not yet complete. Every response carries a dataset_note saying so.

Complete source (case law). de_rii_case_search / de_rii_get_case_text query rechtsprechung-im-internet.de directly. Per an independent audit (Legal Data Hunter, worldwidelaw/legal-sources), RII's coverage of BVerfG, BGH, BAG, BFH, BVerwG and BSG is marked status: complete - unlike NeuRIS's /v1/case-law, which only carries a small beta slice (and can drop fields such as ecli for the very same decision RII serves with a full ECLI - see BAG decision KARE600069049 / ECLI:DE:BAG:2024:... as a live example). Prefer the RII tools for these six courts.

State courts + full-text search (Open Legal Data). de_oldp_case_search / de_oldp_get_case query de.openlegaldata.io - a community open-data aggregator (Open Knowledge Foundation ecosystem, BMBF Prototypefund) of ~424k decisions from ~1 100 German courts at every level, including the state courts of all 16 Laender. It is NOT an official government service and does not claim completeness - for the six federal supreme courts prefer the RII tools; use OLDP for state case law and for full-text hunting (no other source here searches decision content).

Legislative history (Bundestag DIP). de_dip_search / de_dip_get_document query the parliament's official DIP API - Drucksachen (bills, motions, committee reports, government answers - the home of Gesetzesbegruendungen), plenary transcripts and legislative procedures, for Bundestag and Bundesrat. The Bundestag publishes a public API key on its help page (the current one is valid until end of May 2027 and ships as the default); set DE_DIP_API_KEY when it rotates or to use your own key.

Licence. German official works - statutes, ordinances, court decisions and official headnotes - are outside copyright under § 5 UrhG (gemeinfrei), which is the standard basis for reusing German legal data. NeuRIS is operated by the BMJV / DigitalService GmbH; RII is operated by the BMJ (juris GmbH). Neither publishes a separate API terms or key requirement. Open Legal Data's database is under ODbL v1.0 (the decisions themselves are gemeinfrei); DIP data is under Data licence Germany - attribution - 2.0 (dl-de/by-2-0). This connector only relays that public content, with attribution and a source_url. Caveat: NeuRIS is in test phase; re-check the terms at general availability. (This is a practitioner's read, not formal legal advice.)

The tools

Tool What it does
de_search Search legislation by term, ELI and date (GET /v1/legislation).
de_get_act Fetch act metadata by ELI.
de_get_text Fetch the full text (html or xml / LegalDocML.de).
de_list_publishers List the publication organs (BGBl I/II, Bundesanzeiger).
de_recent_changes Acts published since a date, newest-first.
de_case_search / de_get_decision(_text) NeuRIS case-law beta slice (/v1/case-law).
de_rii_case_search Search BVerfG/BGH/BAG/BFH/BVerwG/BSG/BPatG decisions via RII's master TOC (court, Aktenzeichen substring, date range).
de_rii_get_case_text Full text of one RII decision by doc_id - real ecli when the court publishes one, plus titelzeile/leitsatz/tenor/full content.
de_oldp_case_search Search Open Legal Data - 423 944 decisions from 1 119 courts at all levels (verified live 2026-07-08), the only tool here covering state courts and offering full-text search (text). Metadata filters: court_slug, file_number (exact), date_after/date_before.
de_oldp_get_case Full decision text (HTML) by OLDP id or slug, with ECLI when the source carries one.
de_dip_search Search the Bundestag DIP - Drucksachen (287 327), Plenarprotokolle (5 789), Vorgaenge (334 524); filters titel, dokumentnummer, zuordnung (BT/BR), wahlperiode, dates; cursor pagination.
de_dip_get_document One DIP entity by id; the -text resource variants return the full document text. Citations like BT-Drs. 20/1 with the official PDF as source_url.
de_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 (ELI e.g. eli/bund/bgbl-1/2017/s2097/2025-01-01/1/deu, or ECLI for RII case law e.g. ECLI:DE:BVerfG:2024:rk20241120.1bvr226823), human_readable_citation (e.g. BDSG (BGBl I, 2017 2097) or BVerfG, Kammerbeschluss vom 20.11.2024 - 1 BvR 2268/23), and source_url.

Install

cd de-eli-mcp
pip install -e .

Configure (Claude Code / any MCP client)

Copy .mcp.json.example and adjust if needed:

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

Environment:

  • DE_ELI_BASE_URL - default https://testphase.rechtsinformationen.bund.de
  • DE_RII_BASE_URL - default https://www.rechtsprechung-im-internet.de
  • DE_OLDP_BASE_URL - default https://de.openlegaldata.io
  • DE_DIP_BASE_URL - default https://search.dip.bundestag.de
  • DE_DIP_API_KEY - default: the public key the Bundestag documents on dip.bundestag.de/über-dip/hilfe/api (valid until end of May 2027; rotates ~yearly)
  • DE_ELI_CACHE_DIR - default ~/.matematic/cache/de-eli
  • DE_ELI_AUDIT_DIR - default ~/.matematic/audit

NeuRIS, RII and Open Legal Data are keyless. DIP needs an API key, but the Bundestag publishes a public one (shipped as the default) - zero setup either way.

Governance

  • Public data only - read-only against NeuRIS; no client data leaves the machine beyond search parameters.
  • Audit log - every tool call appends one JSON line to ~/.matematic/audit/de-eli-mcp.jsonl.
  • Vendor-neutral - the server talks only to NeuRIS and the local filesystem; no LLM provider, no telemetry.
  • Verifiable citations - every response is independently checkable via source_url.

See CONSTITUTION.md (the binding rules) and DISCOVERY.md (the NeuRIS API map).

Tests

pip install -e ".[dev]"
# offline (fixtures)
pytest tests/test_instructions_drift.py tests/test_rii_client.py tests/test_oldp_client.py tests/test_dip_client.py -v
# live smokes (NeuRIS + RII + Open Legal Data + DIP)
pytest tests/test_smoke.py -v

Licence

Apache-2.0. © Matematic Solutions / Wieslaw Mazur.

Release files for de-eli-mcp 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for de-eli-mcp 0.5.1
File Size Uploaded
de_eli_mcp-0.5.1.tar.gz 76.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for de-eli-mcp 0.5.1
File Interpreter ABI Platform
de_eli_mcp-0.5.1-py3-none-any.whl Python 3 none any Details

Total release size: 124.7 kB

Release files / de_eli_mcp-0.5.1.tar.gz

Download URL de_eli_mcp-0.5.1.tar.gz
Size 76.1 kB
Tags Source
SHA-256 checksum
How to use checksums
da3f5350dd61e65d5f3e5216ce2d1a0fa707e23ccbef8787422d577dbf12980c
BLAKE2b-256 checksum
How to use checksums
33e4bc95095a52bf00bd391f8c51ba0322588b24d36e70cf9912361f3753e098
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / de_eli_mcp-0.5.1-py3-none-any.whl

Download URL de_eli_mcp-0.5.1-py3-none-any.whl
Size 48.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
129422506d811cb9e10f6e623af39bf9480d81fb53586c5ad1005a4f56906dc3
BLAKE2b-256 checksum
How to use checksums
ae61e018e2dd95bb64ba1ff625a8e28abfee70d6d7786754f1e2a0da6449c4d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

0.5.3

2 release files

0.5.2

2 release files

This release

0.5.1 This release

2 release files

0.5.0

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.3.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page