Skip to main content
Glama

🇨🇭 Part of the Swiss Public Data MCP Portfolio

⚖️ openlex-mcp

Version License: MIT Python 3.11+ MCP No Auth Required

MCP Server for Canton Zurich legislation (ZH-Lex) — full-text search, article extraction, and education law tools for ~970 cantonal laws

🇩🇪 Deutsche Version


Overview

openlex-mcp provides AI-native access to the entire legal collection of Canton Zurich (Zürcher Gesetzessammlung). It combines full-text data from HuggingFace with live metadata from the official zh.ch website, storing everything in a local SQLite database with FTS5 full-text indexing for sub-50ms search performance.

Source

Data

Access

HuggingFace

974 ZH laws — full text (PDF extracts)

Cached locally as SQLite + FTS5

zh.ch ZH-Lex

Current metadata, PDF links, validity status

Live HTTP requests

Built for the Schulamt (school department) of the City of Zurich, but covers all areas of cantonal law — from tax law to building regulations.

Anchor demo query: "What does the Volksschulgesetz say about parental involvement? Show me Art. 55 VSG and find all articles that mention 'Elternrat'."


Related MCP server: swiss-courts-mcp

Features

  • ⚖️ 8 tools covering search, retrieval, article extraction, and cache management

  • 🔍 FTS5 full-text search across ~970 cantonal laws with BM25 ranking

  • 📑 Article extraction — parse individual articles (Art. / §) with paragraph detection

  • 🏫 Education law shortcuts — specialized search for LS 412.x series (Volksschulgesetz, Lehrpersonalverordnung, etc.)

  • 🌐 Live metadata from zh.ch for current validity status and PDF links

  • 💾 Hybrid architecture — cached full-text (HuggingFace) + live metadata (zh.ch)

  • 🔓 No API key required — all data under open licenses (CC-BY-SA 4.0)

  • ☁️ Dual transport — stdio (Claude Desktop) + Streamable HTTP (cloud)


Development Phase

Current phase: Phase 1 — Read-Only. All tools are read-only (readOnlyHint: true); no writes to external systems. See ROADMAP.md for the phase plan and transition gates before any write or multi-agent capability is added.


Prerequisites

  • Python 3.11+

  • uv (recommended) or pip

  • Internet connection (for initial data download and live metadata)


Installation

# Clone the repository
git clone https://github.com/malkreide/openlex-mcp.git
cd openlex-mcp

# Install
pip install -e .
# or with uv:
uv pip install -e .

Quickstart

# stdio (for Claude Desktop)
python -m openlex_mcp.server

# Streamable HTTP — binds to 127.0.0.1:8000 by default (localhost only)
python -m openlex_mcp.server --http --port 8000

Network binding

By default the HTTP transport binds to 127.0.0.1 (localhost only). The host and port are configurable via the MCP_HOST / MCP_PORT environment variables (or the --host / --port CLI flags, which take precedence).

Never bind to 0.0.0.0 outside a container — it exposes the server to your local network (NeighborJack risk). For containerized/cloud deployments set MCP_HOST=0.0.0.0 explicitly; when that happens outside a detected container the server logs a warning.

Try it immediately in Claude Desktop:

"What is the Volksschulgesetz (VSG)?" "Find all Zurich laws about data protection" "Show me Art. 1 of the Volksschulgesetz" "Which education laws mention 'Schulleitung'?"


Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "openlex": {
      "command": "python",
      "args": ["-m", "openlex_mcp.server"]
    }
  }
}

Or with the installed entry point:

{
  "mcpServers": {
    "openlex": {
      "command": "openlex-mcp"
    }
  }
}

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Cloud Deployment (SSE for browser access)

For use via claude.ai in the browser (e.g. on managed workstations without local software):

Render.com (recommended):

  1. Push/fork the repository to GitHub

  2. On render.com: New Web Service → connect GitHub repo

  3. Set start command: python -m openlex_mcp.server --http --port 8000

  4. Set environment variable MCP_HOST=0.0.0.0 so the container is reachable (the code default is 127.0.0.1; Render sets the RENDER env var, so no NeighborJack warning is logged)

  5. Set MCP_CORS_ORIGINS=https://claude.ai so the browser can read the Mcp-Session-Id header (comma-separated list; no wildcard — defaults to empty, i.e. no cross-origin access)

  6. In claude.ai under Settings → MCP Servers, add: https://your-app.onrender.com/sse

💡 "stdio for the developer laptop, SSE for the browser."


Available Tools

Search & Browse

Tool

Description

openlex__zhlaw_search_laws

Full-text search across all ~970 ZH laws (FTS5 + BM25 ranking)

openlex__zhlaw_get_law

Retrieve a law by LS number (e.g. 412.100) or abbreviation (e.g. VSG)

openlex__zhlaw_list_laws

List and filter laws by legal area prefix

openlex__zhlaw_find_education_laws

Specialized search in education law (LS 412.x series)

Article Extraction

Tool

Description

openlex__zhlaw_get_article

Extract a specific article from a law (e.g. Art. 28 VSG)

openlex__zhlaw_search_articles

Search within all articles of a specific law

Metadata & Cache

Tool

Description

openlex__zhlaw_get_law_metadata

Get live metadata from zh.ch (PDF links, validity status)

openlex__zhlaw_update_cache

Refresh the local data cache from HuggingFace

Prefix

Legal Area

Example

131

Constitution and popular rights

Kantonsverfassung

170

Administrative procedure

Datenschutzgesetz

331

Tax law

Steuergesetz

412

Education and schools

Volksschulgesetz (VSG)

700

Spatial planning and building

Planungs- und Baugesetz

810

Health

Gesundheitsgesetz

Example Use Cases

Query

Tool

"What is the Volksschulgesetz?"

openlex__zhlaw_get_law

"Find laws about data protection"

openlex__zhlaw_search_laws

"Show me Art. 55 VSG"

openlex__zhlaw_get_article

"Which education laws mention Schulleitung?"

openlex__zhlaw_find_education_laws

"Find all articles about Elternrat in the VSG"

openlex__zhlaw_search_articles

"Is LS 412.100 still in force?"

openlex__zhlaw_get_law_metadata


Architecture

┌─────────────────┐     ┌──────────────────────────────┐     ┌──────────────────────────┐
│   Claude / AI   │────▶│  OpenLex MCP                 │────▶│  HuggingFace             │
│   (MCP Host)    │◀────│  (MCP Server)                │◀────│  rcds/swiss_legislation   │
└─────────────────┘     │                              │     │  (974 ZH laws, cached)   │
                        │  8 Tools                     │     ├──────────────────────────┤
                        │  SQLite + FTS5 Cache         │────▶│  zh.ch ZH-Lex            │
                        │  Stdio | HTTP                │◀────│  (live metadata + PDFs)  │
                        │                              │     ├──────────────────────────┤
                        │  No authentication required  │     │  LexFind.ch              │
                        └──────────────────────────────┘     │  (links only)            │
                                                             └──────────────────────────┘

Data Source Characteristics

Source

Protocol

Coverage

Auth

License

HuggingFace rcds/swiss_legislation

Datasets API

974 ZH laws (full text)

None

CC-BY-SA 4.0

zh.ch ZH-Lex

HTTP/HTML

Current metadata, PDFs

None

Public

LexFind.ch

HTTP

Cross-cantonal links

None

Public

Design Decision: Tools-only (no MCP Resources)

All 8 endpoints are exposed as Tools rather than MCP Resources. Rationale:

  • Every lookup is parametric — queries, abbreviations, article numbers vary per call. Static Resources (one URI per document) don't capture this naturally.

  • The corpus is 974 laws × many articles — registering each as a Resource URI would create an impractically large resource list.

  • MCP Resource templates (zhlex://laws/{sr_number}) are a future consideration for Phase 2 if clients benefit from resource-level caching or subscriptions.

Scaling Constraints

The constraint depends on the protocol era the client speaks:

  • 2026-07-28 (modern) — every request is a self-contained POST carrying its own _meta envelope; the server answers without issuing an Mcp-Session-Id and keeps no session between requests. Any replica can answer any request; no shared store, no sticky routing. (subscriptions/listen streams live on the replica that opened them — this server's lists are fixed at import, so there is nothing to fan out.)

  • Handshake era (initialize, up to 2025-11-25) — session state is kept in-process. Multiple replicas break active sessions because there is no shared session store (Redis, Durable Objects, etc.). A single-replica Render deployment routes all requests to one process, so no sticky-session LB is needed today.

Before scaling handshake-era clients beyond one instance: either add a shared session store or configure your edge load balancer to route on the Mcp-Session-Id header with a stick-table and an appropriate TTL.


MCP Protocol Version

Item

Value

Served via the initialize handshake

2024-11-05 … 2025-11-25 — the handshake ceiling

Served via the per-request envelope

2026-07-28

Who picks

The client's first request, once per connection. A request carrying the 2026-07-28 _meta envelope opens a modern connection; anything else opens a handshake connection.

SDK

mcp[cli]>=2.0.0,<3

Cache hints

tools/list, prompts/list, resources/list, resources/templates/list and server/discover: ttlMs 300000, cacheScope public

serverInfo.version

The package version (openlex_mcp.__version__), in every server/discover result

Deprecated in 2026-07-28, not used

Logging (ctx.info/ctx.warning, SEP-2577) — status goes into the tool result, diagnostics into the server log

Pinned in

src/openlex_mcp/server.py — MCP_PROTOCOL_VERSION constant

Update policy

  1. When mcp is upgraded (via Dependabot PR), verify the protocol version in the SDK release notes.

  2. If the protocol version changes, update MCP_PROTOCOL_VERSION in server.py, regenerate docs/tool-hashes.json (PYTHONPATH=src python scripts/gen_tool_hashes.py --write), and note the change in CHANGELOG.md.

  3. Run pytest tests/ -m "not live" to confirm compatibility before merging.


Project Structure

openlex-mcp/
├── src/openlex_mcp/
│   ├── __init__.py              # Package
│   ├── __main__.py              # Entry point for python -m
│   ├── server.py                # 8 MCP tool definitions (FastMCP) + Settings
│   ├── responses.py             # Typed structured response envelopes (SDK-002)
│   ├── logging_config.py        # structlog JSON logging setup (OBS-003)
│   ├── net.py                   # SSRF/egress-hardened outbound HTTP
│   ├── api_client.py            # zh.ch HTTP client + metadata extraction
│   ├── data_cache.py            # SQLite + FTS5 cache management
│   └── law_parser.py            # Article extraction from law texts
├── tests/                       # 89 unit tests (parser, cache, net, tools…)
├── scripts/gen_tool_hashes.py   # Tool-definition hash snapshot (SEC-022)
├── docs/                        # network-egress, secret-management, tool-hashes
├── .github/workflows/ci.yml     # GitHub Actions (Python 3.11/3.12/3.13)
├── .github/dependabot.yml       # Monthly grouped dependency PRs (ARCH-012)
├── Dockerfile                   # Hardened multi-stage build (SEC-007/SCALE-004)
├── compose.yml                  # Resource limits for local testing (SCALE-006)
├── pyproject.toml
├── claude_desktop_config.json   # Example config for Claude Desktop
├── CHANGELOG.md
├── ROADMAP.md                   # Phase plan + accepted-risk register
├── CONTRIBUTING.md              # Contribution guide (English)
├── CONTRIBUTING.de.md           # Contribution guide (German)
├── SECURITY.md                  # Security policy (English)
├── SECURITY.de.md               # Security policy (German)
├── LICENSE
├── README.md                    # This file (English)
└── README.de.md                 # German version

Tool output format

All tools return a structured response envelope (not Markdown text), so MCP clients receive structuredContent they can parse directly:

{
  "source": "Kanton Zürich Rechtssammlung — HuggingFace … & zh.ch",
  "provenance": "cache",          // cache | live | parser | cache+parser | none
  "result_type": "law_summaries", // law_summaries | law_detail | articles | metadata | cache_status
  "count": 2,
  "message": null,                // human-readable guidance for empty/edge results
  "results": [ /* typed items */ ]
}

Known Limitations

  • HuggingFace dataset: The html_content field is unreliable (cross-contaminated between laws); the server uses pdf_content instead, which is correct but has PDF extraction artefacts (hyphenation, layout artefacts)

  • Article parser: PDF text extraction sometimes merges article boundaries; complex nested articles may not parse perfectly

  • Initial load: First start requires ~25s to download and index 974 laws from HuggingFace (~38 MB SQLite database)

  • zh.ch metadata: No official API; metadata extraction relies on HTML patterns that may change

  • Offline mode: Full-text search works offline after initial load; live metadata requires internet

  • The corpus is frozen at 2023-01-01. This is the limitation that matters most for a legal server, and it was the one not stated. The newest version in the entire dataset carries version_active_since = 2023-01-01; the HuggingFace dataset itself was last touched 2024-10-10. The 24-hour cache TTL and provenance="cache" describe where an answer came from, not how old the laws in it are. Every response now carries corpus_as_of and corpus_note alongside provenance.

  • Repeals after the cut-off are invisible. All 974 entries carry is_active = True and not one has a version_inactive_since. That is not a server bug — the source lists only the statutes in force at snapshot time. The consequence is what matters: a law repealed since then still appears to be in force. Consult the ZH-Lex permalink for the operative text.

  • zhlaw_update_cache does not make the laws newer. It re-downloads the same frozen dataset. Its docstring previously read "only call when law search results seem outdated", which suggested exactly the effect it does not have.


Safety & Limits

Aspect

Details

Access

Read-only (readOnlyHint: true) — the server cannot modify or delete any data

Personal data

No personal data — all sources are aggregated, public legal texts

Rate limits

Built-in per-query caps (max 50 search results, 5000 chars content preview)

Timeout

30 seconds per HTTP call to zh.ch

Egress

Outbound requests are restricted to an allow-list (www.zh.ch over HTTPS, plus the HTTP-only legacy permalink host www.zhlex.zh.ch), with SSRF IP-blocking and DNS-pinning — see docs/network-egress.md

Authentication

No API keys required — HuggingFace dataset is public, zh.ch is open

Security posture (Lethal Trifecta)

Score 1 / 3: public data only (no private/sensitive data) ✓ · GET-only egress to *.zh.ch — no POST, no webhooks, no email ✓ · no code execution ✓. Structurally safe by design.

Session handling

Mcp-Session-Id generated and managed by the MCP SDK (cryptographically secure UUIDs). No user-identity binding — auth_model=none is correct for public read-only data. If authentication is ever added, bind sessions to the validated OAuth sub claim before deployment.

Secrets

No secrets held — all data sources are public. See docs/secret-management.md.

Licenses

Law data: CC-BY-SA 4.0 (rcds/swiss_legislation); zh.ch metadata: public

Terms of Service

Subject to ToS of HuggingFace and Canton Zurich

Disclaimer

This server provides legal texts for informational purposes only — it does not constitute legal advice

To report a vulnerability, see the Security Policy.


Testing

# Unit + contract tests (no network) — this is what CI runs
PYTHONPATH=src pytest tests/ -m "not live"

# Live tests against zh.ch and HuggingFace
PYTHONPATH=src pytest tests/ -m "live"

# Re-measure the corpus date and the live hosts
PYTHONPATH=src python scripts/record_fixtures.py

150 tests — 142 offline, 8 live. Eight tools, eight live tests: the best coverage in this portfolio, which is why the finding here is not about mechanics but about a confusion between two questions. provenance="cache" answers where an answer came from; corpus_as_of answers how old the laws in it are. Only the first was ever answered, and the second is the one a user means when they ask "is this current?".

A measurement limit, deliberately not resolved by editing a test

test_live_get_law_metadata fails in the recording environment: zhlex.zh.ch is not reachable from it. Nothing follows from that. Public DNS resolves the host (NOERROR, 194.247.8.174) and an NXDOMAIN control shows the query discriminates — so the limit is the environment's, not the source's.

The test was therefore left untouched. A test you see red because your own network cannot get out is not a test to rewrite; rewriting it would leave you measuring your own environment instead of the source. PROVENANCE.md records this as open.


Changelog

See CHANGELOG.md


Roadmap

See ROADMAP.md


Contributing

See CONTRIBUTING.md


Security

See SECURITY.md


License

MIT License — see LICENSE


Author

Hayal Oezkan · malkreide


Installation

Run via uv's uvx — no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

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

Available Tools

8 tools
openlex__zhlaw_find_education_lawsA
Read-onlyIdempotent

Sucht gezielt im Zürcher Bildungsrecht (Ordnungsnummern 412.x).

<use_case>Bevorzuge dieses Tool gegenüber openlex__zhlaw_search_laws wenn die Anfrage klar im Bildungsbereich liegt (Schule, Lehrpersonen, Kindergarten, Sonderpädagogik, Tagesstrukturen). Schneller und präziser als die allgemeine Suche, da nur die 412.x-Serie (VSG, VSV, LPG, LPVO, VSM u.a.) durchsucht wird.</use_case>

<important_notes>Sucht ausschliesslich in aktiven 412.x-Gesetzen. Bei keinen Treffern: automatischer Fallback auf alle Rechtsgebiete mit Hinweis im message- Feld. Für Artikel innerhalb eines gefundenen Gesetzes: openlex__zhlaw_search_articles. Synergie: Fundstelle + swiss-courts-mcp → Rechtsprechung finden.</important_notes>

query='Elternrat', limit=10

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_get_articleA
Read-onlyIdempotent

Extrahiert einen einzelnen Artikel aus einem Zürcher Gesetz.

<use_case>Wenn der genaue Wortlaut eines bestimmten Artikels benötigt wird. Voraussetzung: Gesetz und Artikelnummer sind bekannt. Um zuerst relevante Artikel zu finden: openlex__zhlaw_search_articles nutzen.</use_case>

<important_notes>Unterstützt Standard-Artikelnummern (28), Buchstaben-Artikel (28a) und Bis-Artikel (28bis). Liefert Titel, alle Absätze und Volltext des Artikels. Gibt count=0 zurück wenn der Artikel nicht existiert — Artikelnummer ohne 'Art.' angeben (nur die Zahl).</important_notes>

law_identifier='VSG', article_number='28'

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_get_lawA
Read-onlyIdempotent

Ruft ein Zürcher Gesetz anhand der Ordnungsnummer oder Abkürzung ab.

<use_case>Wenn die Ordnungsnummer oder Abkürzung eines Gesetzes bereits bekannt ist und Metadaten oder Volltext abgerufen werden sollen. Um ein Gesetz erst zu finden, openlex__zhlaw_search_laws oder openlex__zhlaw_find_education_laws vorschalten.</use_case>

<important_notes>Unterstützt LS-Nummern ('412.100') und Abkürzungen ('VSG'). include_content=True liefert den Volltext (bis 5000 Zeichen, dann truncated=True). Bei Truncation: openlex__zhlaw_get_article für einzelne Artikel verwenden. Wichtige Gesetze: VSG, LPG, PBG, StG, KV.</important_notes>

identifier='VSG', include_content=False

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_get_law_metadataA
Read-onlyIdempotent

Ruft aktuelle Metadaten eines Gesetzes live von zh.ch ab.

<use_case>Wenn der aktuelle Stand eines Gesetzes auf zh.ch geprüft werden soll — z.B. ob es kürzlich geändert wurde, welche PDF-Version aktuell gilt oder welche ZH-Lex URL direkt verlinkt werden kann. Einziges Tool mit Live-HTTP-Aufruf; alle anderen Tools lesen den lokalen Cache.</use_case>

<important_notes>Macht einen echten HTTP-Request an www.zh.ch (ca. 1–3 s). Erfordert Netzwerkzugang. Liefert: Seitentitel, PDF-Links, Änderungsdatum, ZH-Lex URL. Bei 404 oder Timeout: found=False mit Fehlerdetail im error-Feld. Nur Ordnungsnummern akzeptiert (kein Abkürzungs-Lookup).</important_notes>

sr_number='412.100'

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_list_lawsA
Read-onlyIdempotent

Listet Zürcher Gesetze auf mit optionalem Filter nach Rechtsgebiet.

<use_case>Wenn eine strukturierte Übersicht aller Gesetze eines Rechtsgebiets benötigt wird (z.B. alle aktiven Bildungsgesetze). Für gezielte Textsuche ist openlex__zhlaw_search_laws besser; für reines Bildungsrecht openlex__zhlaw_find_education_laws.</use_case>

<important_notes>sr_prefix filtert nach Ordnungsnummer-Prefix (412=Bildung, 331=Steuern, 700=Bau, 131=Verfassung, 810=Gesundheit). active_only=True blendet aufgehobene Gesetze aus. Unterstützt Paginierung via offset. Gibt Titel, Abkürzung, SR-Nummer und Status zurück — keinen Volltext.</important_notes>

sr_prefix='412', active_only=True, limit=50

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_search_articlesA
Read-onlyIdempotent

Durchsucht alle Artikel eines bestimmten Gesetzes nach einem Begriff.

<use_case>Wenn bekannt ist, in welchem Gesetz gesucht werden soll, aber nicht welcher Artikel relevant ist. Liefert alle Treffer-Artikel mit Inhalt. Für einen einzelnen Artikel mit bekannter Nummer: openlex__zhlaw_get_article.</use_case>

<important_notes>Parst das Gesetz in einzelne Artikel und durchsucht Titel und Inhalt. Suche ist case-insensitive, kein FTS5 (einfaches Substring-Match). Gibt count=0 wenn kein Artikel den Begriff enthält. Benötigt Volltext im Cache — bei fehlendem Inhalt: Hinweis im message-Feld.</important_notes>

law_identifier='VSG', query='Elternrat'

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_search_lawsA
Read-onlyIdempotent

Volltextsuche in allen Zürcher Gesetzen mit FTS5-Ranking.

<use_case>Allgemeine Suche nach einem Rechtsbegriff über alle ~970 kantonalen Gesetze. Wähle dieses Tool wenn das Rechtsgebiet unbekannt ist. Für das Bildungsrecht (412.x) ist openlex__zhlaw_find_education_laws schneller und präziser. Um Artikel innerhalb eines bekannten Gesetzes zu finden, nutze openlex__zhlaw_search_articles.</use_case>

<important_notes>FTS5-Syntax: AND, OR, NOT, Phrasensuche "...". Ergebnisse nach BM25-Relevanz sortiert. Max 50 Treffer pro Aufruf (limit-Parameter). sr_prefix filtert nach Rechtsgebiet (412=Bildung, 331=Steuern, 700=Bau). Sucht im lokalen Cache — Aktualität der Metadaten via openlex__zhlaw_get_law_metadata prüfen.</important_notes>

query='Elternrat OR Elternmitwirkung', sr_prefix='412', limit=10

Inputs: params (required). Returns: count, source, message, results, +4 more

openlex__zhlaw_update_cacheA
Idempotent

Aktualisiert den lokalen Cache der Zürcher Gesetzesdaten.

<use_case>Nur aufrufen wenn der Cache explizit neu geladen werden soll. Der Cache wird automatisch beim Start befüllt und ist 24 Stunden gültig — manuelles Update ist selten nötig.</use_case>

<important_notes>Lädt ~970 Gesetze von HuggingFace (rcds/swiss_legislation) in die lokale SQLite-DB mit FTS5-Index (~25 s erster Lauf). force=False überspringt den Download wenn Cache <24h alt (gibt status='cache_fresh' zurück). force=True erzwingt Neudownload. Erfordert Internetzugang zu HuggingFace.

ACHTUNG — dieses Werkzeug macht die GESETZE nicht aktueller. Es lädt denselben Datensatz erneut, und der ist eingefroren: Die jüngste Fassung darin stammt vom 2023-01-01 (gemessen am 2026-08-08; der Datensatz selbst wurde zuletzt am 2024-10-10 angefasst). Bei Zweifeln an der Aktualität eines Wortlauts hilft nur der ZH-Lex-Permalink, nicht dieses Werkzeug.</important_notes>

force=False

Inputs: params (required). Returns: count, source, message, results, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    Each tool targets a distinct action (list, search, get, update cache), but find_education_laws and search_laws (especially with sr_prefix='412') overlap, as do get_law and get_law_metadata in returning metadata. Descriptions explicitly guide selection, reducing practical confusion.

    Naming Consistency4/5

    All names use snake_case with a consistent zhlaw_ prefix and verb_noun pattern, making them predictable. The only minor inconsistency is using 'find' for one search operation while others use 'search'.

    Tool Count5/5

    Eight tools are well-scoped for Zurich legal research, covering listing, searching, retrieving, and cache maintenance without redundancy. Each tool earns its place.

    Completeness4/5

    The surface covers core legal research workflows: list laws, search laws/articles, retrieve laws/articles, live metadata, and cache update. A minor gap is the lack of bulk article retrieval for large laws (get_law truncates at 5000 chars), though get_article works around this.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers