legal-text-mcp-de

Cite-grade German legal-text infrastructure for LLM agents. ~8 500 federal + Länder + EU laws via MCP, HTTP API, and a typer shell CLI — all over the same runtime, with cryptographic provenance from gesetze-im-internet.de and EUR-Lex / Cellar.

It is local or server-side infrastructure: no SaaS, no billing, no accounts, no tenant model, and no legal advice. The runtime loads either the committed fixture packages used by fast CI or a generated production corpus package built outside Git. Official text comes from gesetze-im-internet.de for German federal laws and from EUR-Lex / Cellar for EU acts such as the GDPR.

No legal advice. This software returns text and structured metadata. It does not interpret the law, advise on it, or produce any legal conclusion. The maintainer assumes no liability for use in legal decision-making contexts.

Older internal documentation has been archived under docs-legacy/summary.md.

Status

Features

• MCP tools for listing laws, fetching norms, resolving citations, full-text search, and source provenance.
• HTTP API (FastAPI) over the same runtime, with structured /health, /ready, /laws, /search, and OpenAPI endpoints.
• Provenance-first design: every law and norm carries source URL, fetch timestamp, content hash, and the parser path it traversed.
• Two corpus modes: committed fixture packages for deterministic tests and CI, or a generated production package built from official sources at runtime.
• No editorial bundling: this repository ships tooling, not legal text. Texts are loaded from official sources at runtime.

Installation

Mode 1 — pip install from PyPI (smallest dependency)

pip install legal-text-mcp-de==2.1.3
DATASET_PATH=/path/to/corpus.tar.zst legal-text-mcp-de serve

The package ships the runtime only; provide a corpus bundle via DATASET_PATH (build with prepare_data.build_corpus, see Mode 4) or point at an existing .tar.zst you trust.

Mode 2 — uvx + auto-download (recommended, easiest)

uvx legal-text-mcp-de serve

Server fetches the latest signed corpus bundle from GHCR on first run.

Mode 3 — Docker with pre-bundled corpus

docker run -p 8001:8001 ghcr.io/klein-business/legal-text-mcp-de-full:2.1.3 serve

Mode 4 — Self-built corpus (compliance-sensitive)

git clone https://github.com/klein-business/legal-text-mcp-de
cd legal-text-mcp-de
uv run python -m prepare_data.build_corpus --output ./my-corpus.tar.zst --sources land:by,land:nrw
DATASET_PATH=./my-corpus.tar.zst uvx legal-text-mcp-de serve

Mode 5 — Public-hosted service

// claude_desktop_config.json
{
  "mcpServers": {
    "legal-de": {
      "url": "https://mcp.klein.business/legal/de",
      "transport": "streamable-http"
    }
  }
}

CLI

legal-text-mcp-de ships a full subcommand CLI. Bare invocation prints --help. Common commands:

legal-text-mcp-de serve              # start the MCP server (replaces the v2.0 bare invocation)
legal-text-mcp-de http               # start the FastAPI HTTP API
legal-text-mcp-de laws --query DSGVO # list laws
legal-text-mcp-de norm BGB "§ 433"   # fetch a single norm
legal-text-mcp-de search Werbung     # full-text search
legal-text-mcp-de corpus pull        # download the signed corpus bundle
legal-text-mcp-de corpus verify      # cosign-verify the local bundle
legal-text-mcp-de version            # version + Python + platform

Add --json to any subcommand for machine-readable output (matches the HTTP API's response schema). See CLI reference for the full subcommand list.

BREAKING in v2.1.0: bare legal-text-mcp-de now prints --help. Append serve to keep the v2.0 behaviour (started the MCP server).

Quickstart

Run the MCP server with the committed fixture corpus

uv sync --all-groups

DATASET_PATH=tests/fixtures/normalized \
STRICT_STARTUP=true \
uv run legal-text-mcp-de serve

The default transport is streamable HTTP at http://localhost:8001/mcp. For desktop / offline clients use the stdio transport instead — see Quickstart → stdio.

Dev shortcut. A Justfile wraps the common uv invocations (just install, just test, just lint, just run, just api, just docs). Install via brew install just. The Justfile is optional — CI only uses uv directly.

Run the HTTP API

Since v2.1 the easiest way is the new CLI:

DATASET_PATH=tests/fixtures/normalized \
STRICT_STARTUP=true \
uv run legal-text-mcp-de http

The default port is 8001 (from settings.port / PORT env var); use --port <N> to override.

Or directly via uvicorn (equivalent — same FastAPI app):

DATASET_PATH=tests/fixtures/normalized \
STRICT_STARTUP=true \
uv run uvicorn legal_text_mcp_de.http_api:app --host 127.0.0.1 --port 8001

The HTTP layer enforces MAX_REQUEST_BODY_BYTES (default 1048576 = 1 MiB) as a defence-in-depth body-size cap; over-limit requests return 413 Payload Too Large. The operator's reverse proxy is still expected to enforce a proxy-level limit on top of this.

Docker

The Docker image does not bundle legal text data. Mount a validated package at /data/legal-texts:

docker run --rm -p 8001:8001 \
  -v /path/to/legal-text-package:/data/legal-texts:ro \
  ghcr.io/klein-business/legal-text-mcp-de:2.1.3 serve

• See examples/docker-compose/http/ for a minimal HTTP-mode Compose example.
• See examples/docker-compose/production/ for a committed, CI-tested production stack (MCP + HTTP behind Caddy, switchable via Compose profiles).

MCP Resources

Since v2.0, the corpus is exposed as read-only legal:// URIs that any MCP client can load directly into its LLM context. Examples:

• legal://laws — paginated index
• legal://laws/bgb — BGB header + norm index
• legal://laws/bgb/norms/par:433 — § 433 BGB as Markdown
• legal://corpus/coverage — what's in the corpus

See docs/concepts/mcp-native.md for the full URI catalogue.

MCP Prompts (slash-commands)

Five curated workflows appear as slash-commands in MCP clients: