Entscheidsuche — Schweizer Gerichtsentscheide

Official6 toolsLive

by entscheidsuche · Python

Suche in Schweizer Gerichtsentscheiden aller Instanzen (Bund, Kantone) in DE/FR/IT.

ch.entscheidsuche/mcp (MCP)

This MCP server searches Swiss court decisions across all instances (federal courts and cantonal courts) and provides access to published full text. It supports German, French, and Italian, and is positioned as a beta offering. The server is identified by the slug ch-entscheidsuche-mcp and provides 6 tools.

🛠️ Key Features

Full-text search and full-text access to published court decisions
Coverage across Swiss instances, including Bundesgerichte and kantonale Gerichte
Languages: DE / FR / IT
Mentions access to Verwaltungsbehörden and Strafbefehle

🚀 Use Cases

Query Swiss jurisprudence in multilingual formats
Retrieve published decisions for analysis and review
Search across both federal and cantonal judicial bodies

⚡ Developer Benefits

MCP integration via Model Context Protocol
Tool set count: 6 (as reported by the server metadata)

⚠️ Limitations

Described as “Beta” in the provided excerpt

Captured live from the server via tools/list.

search

Volltext-Suche in Schweizer Gerichtsurteilen, Gerichtsentscheiden, Rechtsprechung und Swiss case law aus entscheidsuche.ch. Geeignet für Entscheide des Bundesgerichts (BGer, BGE) und kantonaler Gerichte wie Kantonsgericht, Obergericht oder Verwaltungsgericht. Typische Anwendungsfälle: - Bundesgerichtsurteil, BGE oder Gerichtsurteil thematisch suchen - Schweizer Rechtsprechung zu Mietrecht, ZGB, OR, StGB oder BV finden - Geschäftsnummern, Urteilsnummern oder Zitate verifizieren - Verwandte Tools: fetch_document, search_by_case_number, list_hierarchy, list_facets Suchsyntax (Lucene-Query-String): - Phrasen-/Geschäftsnummer-Suche: "BGE 142 III 1" (mit Anführungszeichen) - Boolesche Operatoren: AND, OR, NOT (bzw. +, -) - Wildcards: * und ? - Default-Operator zwischen Begriffen ist AND. Filter werden mit AND verknüpft. Hierarchie-IDs aus `list_hierarchy` oder `list_facets` übernehmen. Paginierung: nach dem ersten Aufruf den `next_cursor`-Wert aus der Antwort als `search_after` im nächsten Aufruf übergeben.

Parameters12

query	string	optional	Volltext-Anfrage. "..." für Phrasen, AND/OR/NOT für Boolesche Verknüpfungen, * und ? für Wildcards. "*" matcht alles.
language	any	optional	Optionale bevorzugte Sprache für Highlight/Anzeige (de, fr, it). Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben — es findet KEINE Filterung statt; dafür `language_filter` setzen.
sort	string	optional	Optionale Sortierung: 'relevance' \| 'date' (Entscheiddatum) \| 'scrapedate'. Default ist 'relevance'.
size	integer	optional	Treffer pro Seite (1–100).
search_after	any	optional	Cursor aus `next_cursor` der vorigen Antwort.
decision_date_from	any	optional	Untergrenze Entscheiddatum (YYYY-MM-DD, inklusive).
decision_date_to	any	optional	Obergrenze Entscheiddatum (YYYY-MM-DD, inklusive).
scrape_date_from	any	optional	Untergrenze Scrape-Datum (YYYY-MM-DD, inklusive).
scrape_date_to	any	optional	Obergrenze Scrape-Datum (YYYY-MM-DD, inklusive).
hierarchy	any	optional	Liste von Hierarchie-IDs (Kanton/Gericht/Kammer). Mehrere IDs werden mit OR verknüpft; mit anderen Filtern AND.
language_filter	any	optional	Filter nach Dokumentsprache(n).
include_aggregations	boolean	optional	Aggregationen mitliefern (Verteilungen über die Treffer).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": "*",
      "description": "Volltext-Anfrage. \"...\" für Phrasen, AND/OR/NOT für Boolesche Verknüpfungen, * und ? für Wildcards. \"*\" matcht alles.",
      "title": "Query",
      "type": "string"
    },
    "language": {
      "anyOf": [
        {
          "$ref": "#/$defs/Language"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale bevorzugte Sprache für Highlight/Anzeige (de, fr, it). Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben — es findet KEINE Filterung statt; dafür `language_filter` setzen."
    },
    "sort": {
      "default": "relevance",
      "description": "Optionale Sortierung: 'relevance' | 'date' (Entscheiddatum) | 'scrapedate'. Default ist 'relevance'.",
      "enum": [
        "relevance",
        "date",
        "scrapedate"
      ],
      "title": "Sort",
      "type": "string"
    },
    "size": {
      "default": 20,
      "description": "Treffer pro Seite (1–100).",
      "maximum": 100,
      "minimum": 1,
      "title": "Size",
      "type": "integer"
    },
    "search_after": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cursor aus `next_cursor` der vorigen Antwort.",
      "title": "Search After"
    },
    "decision_date_from": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Untergrenze Entscheiddatum (YYYY-MM-DD, inklusive).",
      "title": "Decision Date From"
    },
    "decision_date_to": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Obergrenze Entscheiddatum (YYYY-MM-DD, inklusive).",
      "title": "Decision Date To"
    },
    "scrape_date_from": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Untergrenze Scrape-Datum (YYYY-MM-DD, inklusive).",
      "title": "Scrape Date From"
    },
    "scrape_date_to": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Obergrenze Scrape-Datum (YYYY-MM-DD, inklusive).",
      "title": "Scrape Date To"
    },
    "hierarchy": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Liste von Hierarchie-IDs (Kanton/Gericht/Kammer). Mehrere IDs werden mit OR verknüpft; mit anderen Filtern AND.",
      "title": "Hierarchy"
    },
    "language_filter": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Language"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter nach Dokumentsprache(n).",
      "title": "Language Filter"
    },
    "include_aggregations": {
      "default": false,
      "description": "Aggregationen mitliefern (Verteilungen über die Treffer).",
      "title": "Include Aggregations",
      "type": "boolean"
    }
  },
  "$defs": {
    "Language": {
      "description": "Verfügbare Sprachen der Entscheide.",
      "enum": [
        "de",
        "fr",
        "it"
      ],
      "title": "Language",
      "type": "string"
    }
  },
  "title": "searchArguments"
}

search_by_case_number

Spezialsuche für Geschäftsnummern, Urteilsnummern und BGE-Zitate in Schweizer Gerichtsurteilen. Dieses Tool setzt die angegebene Geschäftsnummer automatisch in Anführungszeichen und startet damit eine exakte Phrasensuche, zum Beispiel für 'BGE 142 III 1', '5A_396/2015' oder ähnliche Referenzen aus Bundesgericht, BGer, BGE und kantonaler Rechtsprechung.

Parameters12

case_number	string	required	Geschäftsnummer (Aktenzeichen), BGE-Zitat oder Urteilsnummer, z.B. 'BGE 142 III 1' oder '5A_396/2015'.
language	any	optional	Optionale bevorzugte Sprache für Highlight/Anzeige (de, fr, it). Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben — es findet KEINE Filterung statt; dafür `language_filter` setzen.
sort	string	optional	Optionale Sortierung: 'relevance' \| 'date' (Entscheiddatum) \| 'scrapedate'. Default ist 'relevance'.
size	integer	optional	Treffer pro Seite (1–100).
search_after	any	optional	Cursor aus `next_cursor` der vorigen Antwort.
decision_date_from	any	optional	Optionale Untergrenze Entscheiddatum (YYYY-MM-DD).
decision_date_to	any	optional	Optionale Obergrenze Entscheiddatum (YYYY-MM-DD).
scrape_date_from	any	optional	Optionale Untergrenze Scrape-Datum (YYYY-MM-DD).
scrape_date_to	any	optional	Optionale Obergrenze Scrape-Datum (YYYY-MM-DD).
hierarchy	any	optional	Optionale Hierarchie-IDs für Kanton/Gericht/Kammer.
language_filter	any	optional	Optionale Filter nach Dokumentsprache(n).
include_aggregations	boolean	optional	Optional Aggregationen mitliefern.

Raw schema

{
  "type": "object",
  "properties": {
    "case_number": {
      "description": "Geschäftsnummer (Aktenzeichen), BGE-Zitat oder Urteilsnummer, z.B. 'BGE 142 III 1' oder '5A_396/2015'.",
      "title": "Case Number",
      "type": "string"
    },
    "language": {
      "anyOf": [
        {
          "$ref": "#/$defs/Language"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale bevorzugte Sprache für Highlight/Anzeige (de, fr, it). Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben — es findet KEINE Filterung statt; dafür `language_filter` setzen."
    },
    "sort": {
      "default": "relevance",
      "description": "Optionale Sortierung: 'relevance' | 'date' (Entscheiddatum) | 'scrapedate'. Default ist 'relevance'.",
      "enum": [
        "relevance",
        "date",
        "scrapedate"
      ],
      "title": "Sort",
      "type": "string"
    },
    "size": {
      "default": 20,
      "description": "Treffer pro Seite (1–100).",
      "maximum": 100,
      "minimum": 1,
      "title": "Size",
      "type": "integer"
    },
    "search_after": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cursor aus `next_cursor` der vorigen Antwort.",
      "title": "Search After"
    },
    "decision_date_from": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Untergrenze Entscheiddatum (YYYY-MM-DD).",
      "title": "Decision Date From"
    },
    "decision_date_to": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Obergrenze Entscheiddatum (YYYY-MM-DD).",
      "title": "Decision Date To"
    },
    "scrape_date_from": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Untergrenze Scrape-Datum (YYYY-MM-DD).",
      "title": "Scrape Date From"
    },
    "scrape_date_to": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Obergrenze Scrape-Datum (YYYY-MM-DD).",
      "title": "Scrape Date To"
    },
    "hierarchy": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Hierarchie-IDs für Kanton/Gericht/Kammer.",
      "title": "Hierarchy"
    },
    "language_filter": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Language"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale Filter nach Dokumentsprache(n).",
      "title": "Language Filter"
    },
    "include_aggregations": {
      "default": false,
      "description": "Optional Aggregationen mitliefern.",
      "title": "Include Aggregations",
      "type": "boolean"
    }
  },
  "required": [
    "case_number"
  ],
  "$defs": {
    "Language": {
      "description": "Verfügbare Sprachen der Entscheide.",
      "enum": [
        "de",
        "fr",
        "it"
      ],
      "title": "Language",
      "type": "string"
    }
  },
  "title": "search_by_case_numberArguments"
}

fetch_document

Fetch / retrieve eines einzelnen Schweizer Gerichtsentscheids, Gerichtsurteils oder Bundesgerichtsentscheids anhand seiner Dokument-ID (`_id`). Liefert immer den vollständigen Volltext des Entscheids sowie Metadaten, Titel, Abstract und Links zurück. Geeignet, wenn nach einer Suche der ganze Entscheid gelesen oder weiterverarbeitet werden soll.

Parameters2

id	string	required	Dokument-ID (z.B. 'CH_BGer_001_5A_123_2024_2024-06-15').
language	any	optional	Optionale bevorzugte Sprache für Titel/Abstract. Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Dokument-ID (z.B. 'CH_BGer_001_5A_123_2024_2024-06-15').",
      "title": "Id",
      "type": "string"
    },
    "language": {
      "anyOf": [
        {
          "$ref": "#/$defs/Language"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optionale bevorzugte Sprache für Titel/Abstract. Ohne Angabe wird das erste vorhandene Sprachfeld zurückgegeben."
    }
  },
  "required": [
    "id"
  ],
  "$defs": {
    "Language": {
      "description": "Verfügbare Sprachen der Entscheide.",
      "enum": [
        "de",
        "fr",
        "it"
      ],
      "title": "Language",
      "type": "string"
    }
  },
  "title": "fetch_documentArguments"
}

list_hierarchy

Liefert die verfügbaren Hierarchie-IDs für Schweizer Kantone, Gerichte und Kammern mit Trefferzahlen. Hilfreich, um Bundesgericht, kantonale Gerichte, Obergerichte oder Verwaltungsgerichte für die weitere Suche einzugrenzen.

Parameters2

query	string	optional	Optionale Volltext-Anfrage.
size	integer	optional	Maximale Anzahl Einträge.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": "*",
      "description": "Optionale Volltext-Anfrage.",
      "title": "Query",
      "type": "string"
    },
    "size": {
      "default": 1000,
      "description": "Maximale Anzahl Einträge.",
      "maximum": 10000,
      "minimum": 1,
      "title": "Size",
      "type": "integer"
    }
  },
  "title": "list_hierarchyArguments"
}

list_facets

Hierarchischer Facetten-Baum mit lokalisierten Bezeichnungen für Kantone, Gerichte und Kammern. Die `id`-Felder können im `hierarchy`-Filter der Suche verwendet werden.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "list_facetsArguments"
}

server_info

Versionsinfo und konfigurierte Endpunkt-URLs des MCP-Servers für Schweizer Rechtsprechung und Gerichtsentscheide.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "server_infoArguments"
}

README.md13 KBView on GitHub

entscheidsuche-mcp

MCP-Server für die offene Schweizer Rechtsprechung (Beta) — Volltextsuche und Volltextzugriff auf publizierte Gerichtsentscheide aller Schweizer Instanzen (Bundesgerichte, kantonale Gerichte, Verwaltungsbehörden, Strafbefehle) in Deutsch, Französisch und Italienisch — über das Model Context Protocol.

MCP Server for Swiss case law (beta). Search and retrieve published court decisions from all Swiss instances (federal courts, all 26 cantons, administrative authorities, penal orders) in German, French, and Italian. Operated as open Swiss legal data infrastructure by the non-profit association entscheidsuche.ch, tax-exempt in Switzerland since 2020.

Öffentlicher Endpunkt: https://mcp.entscheidsuche.ch/mcp (Streamable HTTP, ohne Authentifizierung)

Landing Page für Endnutzer: mcp.entscheidsuche.ch — dort steht alles Nötige zur Einrichtung in Claude.ai, ChatGPT, Cursor, VS Code, Claude Desktop und anderen Clients. Dieses Repository richtet sich primär an Entwickler, Drittanwendungen und Selbst-Betreiber.

Über den MCP-Server

Schweizer Gerichtsentscheide sind formal öffentlich, faktisch aber über mehr als 26 kantonale Portale, mehrere Bundesgerichte und unterschiedlich strukturierte Veröffentlichungsformate verteilt. Der Verein entscheidsuche.ch sammelt diese Entscheide seit 2017 ein, indexiert sie volltextlich und macht sie zugänglich. Eine Lizenz gibt es nicht, da Gerichtsentscheide nicht dem Urheberrecht unterstehen. Dieser MCP-Server bringt diesen Bestand zu KI-Assistenten und programmatischen Clients.

Was den Server unterscheidet

Betrieben vom gemeinnützigen Verein entscheidsuche.ch (gegründet 2017 in Landquart GR, seit 2020 in Bern als gemeinnütziger Zweck steuerbefreit) — kollektiv getragene Schweizer Rechtsdaten-Infrastruktur, kein Bastelprojekt
Eigener Datenbestand: tägliche Scrapes direkt aus den Originalquellen aller Schweizer Gerichte. Enthält auch Entscheide, die von Behörden nicht oder nicht in geeigneter Form publiziert werden und über die Upload-Funktion (seit 2021) eingereicht wurden, darunter Strafbefehle
Drei Amtssprachen (DE / FR / IT) mit gezieltem Sprachfilter und sprachübergreifender Suche
Offen — keine Authentifizierung, kein API-Key, lizenzfrei

Tools

Tool	Zweck
`search`	Volltextsuche mit Lucene-Syntax. Filter nach Entscheiddatum, Scrape-Datum, Hierarchie (Kanton / Gericht / Kammer) und Sprache. Sortierung nach Relevanz, Entscheiddatum oder Scrape-Datum. Paginierung über `next_cursor` / `search_after`. Aggregationen für Facetten-Auswertung.
`search_by_case_number`	Exakte Phrasensuche nach Geschäftsnummern, Aktenzeichen und BGE-Zitaten (z.B. `BGE 142 III 1`, `6B_1234/2025`, `5A_396/2015`). Setzt die Nummer automatisch in Anführungszeichen.
`fetch_document`	Vollständigen Entscheid samt Volltext anhand der ID abrufen.
`list_hierarchy`	Hierarchie-IDs (Bund / Kanton / Gericht / Kammer) mit Trefferzahlen.
`list_facets`	Hierarchischer Facetten-Baum mit lokalisierten Labels in DE/FR/IT.
`server_info`	Versions- und Konfigurationsinformationen.

Vollständige Schnittstellenbeschreibung mit allen Parametern, Filtern, Rückgabe-Schemata und Beispielen: docs/API.md.

Suchsyntax — Cheatsheet

Aufgabe	Beispiel
Volltext, alle Begriffe (AND)	`Mietzins Kündigung`
Phrase, exakte Reihenfolge	`"fristlose Kündigung"`
Geschäftsnummer	`"BGE 142 III 1"`
OR	`Mietzins OR Pachtzins`
Negation	`Mietzins NOT Erhöhung`
Wildcard	`Mietz*`
Feld-Suche	`title.de:"Kündigung"`

Standardverknüpfung zwischen Wörtern ist AND. Gesucht wird in title, abstract, meta, attachment.content und reference.

language und sort sind optional. Ohne language erfolgt keine Spracheinschränkung — der Server liefert das erste vorhandene Sprachfeld zurück (de → fr → it). Ohne sort wird nach Relevanz sortiert. Zur expliziten Sprachfilterung dient language_filter. Erlaubte Sprachen: de, fr, it.

Schnelleinbindung in MCP-Clients

Ausführliche, client-spezifische Anleitungen mit Voraussetzungen (Tarif-Anforderungen für claude.ai und ChatGPT, Konfigurations-Pfade) stehen auf der Landing Page und in docs/CLIENTS.md. Im Wesentlichen:

Claude Code (CLI)

bash

claude mcp add --transport http entscheidsuche https://mcp.entscheidsuche.ch/mcp

Cursor / Windsurf / VS Code / Generisch (mcp.json)

json

{
  "mcpServers": {
    "entscheidsuche": {
      "url": "https://mcp.entscheidsuche.ch/mcp"
    }
  }
}

Claude Desktop (stdio-only, daher über die mcp-remote-Bridge):

json

{
  "mcpServers": {
    "entscheidsuche": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.entscheidsuche.ch/mcp"]
    }
  }
}

MCP Inspector zum Testen

bash

npx @modelcontextprotocol/inspector https://mcp.entscheidsuche.ch/mcp

Hinweis: Nicht jede Client-Anleitung ist vollständig durchgespielt; Tarife, Tool-Listen und Konfigurations-Pfade ändern sich bei Anthropic, OpenAI und anderen Anbietern regelmässig. Bei Abweichungen gilt die offizielle Doku des jeweiligen Clients — Rückmeldungen bitte als Issue oder PR.

Lokale Entwicklung

bash

git clone https://github.com/entscheidsuche/entscheidsuche-mcp.git
cd entscheidsuche-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

# Server starten — Streamable HTTP auf 127.0.0.1:8765/mcp
python -m entscheidsuche_mcp

# Alternative: stdio (für lokale CLI-Clients)
python -m entscheidsuche_mcp --transport stdio

Konfiguration (Umgebungsvariablen)

Vollständige Liste in .env.example. Die wichtigsten:

Variable	Default	Bedeutung
`ENTSCHEIDSUCHE_ES_URL`	`https://entscheidsuche.pansoft.de:9200/entscheidsuche.v2-*/_search`	Elasticsearch-Endpoint
`ENTSCHEIDSUCHE_FACETS_URL`	`https://www.recherche.histoirerurale.ch/Facetten.json`	Facetten-Hierarchie
`HOST` / `PORT`	`127.0.0.1` / `8765`	Listen-Adresse
`MCP_PATH`	`/mcp`	HTTP-Pfad
`MCP_STATELESS_HTTP`	`true`	Streamable HTTP ohne Session-Pflicht
`MCP_DNS_REBINDING_PROTECTION`	`true`	Host-/Origin-Prüfung
`PUBLIC_BASE_URL`	`https://mcp.entscheidsuche.ch`	Öffentliche Basis-URL
`LOG_LEVEL`	`INFO`	Loglevel

Schnelltest mit `curl`

bash

# initialize
curl -N -H 'Content-Type: application/json' \
     -H 'Accept: application/json, text/event-stream' \
     http://localhost:8765/mcp \
     -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

# tools/list
curl -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
     http://localhost:8765/mcp \
     -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# search
curl -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
     http://localhost:8765/mcp \
     -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"query":"\"BGE 142 III 1\"","language":"de","size":3}}}'

Komfortabler ist ein echter MCP-Client (MCP Inspector, Claude Code) — der übernimmt die Streamable-HTTP-Session-Verwaltung automatisch.

Eigene Instanz deployen (Debian)

Das Repository enthält eine systemd-Unit, einen nginx-vHost und ein Installations-Script. Damit kann jeder einen eigenen MCP-Endpoint gegen den gleichen Elasticsearch-Index betreiben.

bash

ssh root@your-server.example
git clone https://github.com/entscheidsuche/entscheidsuche-mcp.git /opt/entscheidsuche-mcp
sudo bash /opt/entscheidsuche-mcp/deploy/install.sh

# TLS-Zertifikat
sudo apt-get install -y certbot python3-certbot-nginx
sudo certbot --nginx -d mcp.example.org

Das Script legt den Systemnutzer entscheidsuche an, baut ein venv, kopiert .env.example nach /etc/entscheidsuche-mcp.env, installiert die systemd-Unit und den nginx-vHost.

Status prüfen:

bash

systemctl status entscheidsuche-mcp
journalctl -u entscheidsuche-mcp -f

Nutzungsstatistik (`/statistik`)

Der MCP-Server liefert unter /statistik eine selbst-enthaltene HTML-Seite mit Tageszahlen, Top-Tools, KI-Client-Klassifizierung (clientInfo.name), Stunden-Sparklines und Methoden-Verteilung. Wird bei jedem Aufruf live generiert; Vortage werden in einem JSON-Cache (/var/lib/entscheidsuche-mcp/stats-cache.json) fixiert.

Basic Auth via Env-Variablen (in /etc/entscheidsuche-mcp.env):

bash

ESC_STATS_USER=admin
ESC_STATS_PASS=DEIN_PASSWORT

Sind beide leer, ist /statistik ungeschützt zugänglich (Dev-Modus). Der Authorization-Header wird vom nginx-vHost unverändert an den Python-Server durchgereicht; die Prüfung passiert dort per hmac.compare_digest gegen die Env-Variablen.

Inhalte sind reine Aggregate. Mit ESC_ACCESS_LOG_ARGS_MAX=0 (Default im .env.example) werden Tool-Argumente — also die Suchqueries der Nutzer — gar nicht erst geloggt.

Datenquelle: /var/log/entscheidsuche-mcp/access.log (geschrieben von der entscheidsuche_mcp.access-Middleware). Logrotation z. B. via /etc/logrotate.d/entscheidsuche-mcp einrichten:

code

/var/log/entscheidsuche-mcp/access.log {
    weekly
    rotate 12
    compress
    delaycompress
    missingok
    notifempty
    copytruncate
}

copytruncate ist wichtig, damit der Logger weiter in die rotierte Datei schreibt, ohne dass der Server neu gestartet werden muss.

Architektur

code

MCP-Client (Claude, ChatGPT, Cursor, ...)
       │  Streamable HTTP (JSON-RPC)
       ▼
mcp.entscheidsuche.ch
       │  TLS, nginx Reverse Proxy
       ▼
127.0.0.1:8765/mcp  ← uvicorn + FastMCP
       │  HTTPS
       ▼
Elasticsearch (entscheidsuche.v2-*)

Implementierung: Python + FastMCP.

Trägerverein

Der MCP-Server, die zugrundeliegende Plattform und der Datenbestand werden vom Verein entscheidsuche.ch betrieben.

Gegründet: 2017 in Landquart (GR)
Vereinszweck: Die Rechtsprechung schweizerischer Gerichte für jedermann durchsuchbar und zugreifbar machen (Statuten)
Gemeinnützigkeit: Seit 2020 vom Kanton Bern wegen Verfolgung gemeinnütziger Zwecke von der Steuerpflicht befreit
Vorstand: Jörn Erbguth, Daniel Kettiger, Claudia Schreiber
Kontakt: info@entscheidsuche.ch
Postadresse: Verein entscheidsuche.ch, 3000 Bern
Spendenkonto: Postfinance IBAN CH04 0900 0000 1412 0685 4, Verein entscheidsuche.ch, 8000 Zürich (Spendenquittung auf Anfrage)
Mitgliedschaft: 100 CHF/Jahr für natürliche Personen, 1'000 CHF/Jahr für institutionelle Mitglieder

Die Plattform wurde 2018–2020 durch eine Crowdfunding-Aktion auf wemakeit finanziert. Eine kurze Vorstellung des Projekts erschien im Juli 2021 in der Zeitschrift für Zivilprozess- und Zwangsvollstreckungsrecht (ZZZ).

Die Scraper, mit denen die Entscheide aus den Originalquellen geholt werden, sind ebenfalls open source — siehe Repositories des Vereins auf GitHub.

Beitragen

Issues, Pull Requests und Vorschläge sind willkommen, insbesondere:

Fehlerberichte zur Suche oder zur API
Erweiterungen der MCP-Tools (z.B. Aggregations-/Statistik-Tools, Zitationsgraph)
Verbesserungen der Client-Anleitungen in docs/CLIENTS.md
Übersetzungen

Bei Datenfehlern oder fehlenden Entscheiden bitte direkt an info@entscheidsuche.ch — der Datenbestand wird zentral gepflegt, nicht in diesem Repo.

Lizenz

Code: MIT

Daten: Die zugrundeliegenden Gerichtsentscheide sind amtliche Werke und stehen gemäss URG Art. 5 nicht unter Urheberrechtsschutz. Die strukturierten Aufbereitungen des Vereins entscheidsuche.ch sind frei nutzbar — Details unter entscheidsuche.ch.

Install

Tools (6)

searchsearch_by_case_numberfetch_documentlist_hierarchylist_facetsserver_info

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.entscheidsuche.ch/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.entscheidsuche.ch/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ch.entscheidsuche/mcp (MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search

search_by_case_number

fetch_document

list_hierarchy

list_facets

server_info

entscheidsuche-mcp

Inhalt

Über den MCP-Server

Tools

Suchsyntax — Cheatsheet

Schnelleinbindung in MCP-Clients

Lokale Entwicklung

Konfiguration (Umgebungsvariablen)

Schnelltest mit curl

Eigene Instanz deployen (Debian)

Nutzungsstatistik (/statistik)

Architektur

Trägerverein

Beitragen

Lizenz

Install

Remote endpoint

Related servers

Schnelltest mit `curl`

Nutzungsstatistik (`/statistik`)