entscheidsuche-mcp

Volltextsuche über alle Entscheide. query versteht Lucene-Syntax: "…" für Phrasen, AND/OR/NOT, Wildcards * und ?. Default-Operator zwischen Begriffen ist AND; Filter werden mit AND verknüpft.

Eingabe

Ausgabe

Beispiel

// Aufruf
{ "query": "Mietrecht Kündigung", "sort": "date", "size": 3 }

// Antwort (gekürzt)
{
  "total": 886,
  "hits": [
    {
      "id": "ZH_BK_004_MJ240016-L_2026-04-22",
      "title": "Zürich Bezirksgerichte Mietgericht 22.04.2026 MJ240016-L",
      "abstract": "ZMP 2026 Nr. 6: Mietzinserhöhungen …",
      "text": "Eine <em>Kündigung</em> kann auf jedes Monatsende …",
      "meta": "Zürich Bezirksgerichte Mietgericht",
      "canton": "ZH",
      "court": "ZH_BK",
      "decision_date": "2026-04-22",
      "scrape_date": "2026-05-03",
      "is_pdf": true,
      "document_url": "https://entscheidsuche.ch/docs/ZH_Obergericht/ZH_BK_004_MJ240016-L_2026-04-22.pdf",
      "original_url": null,
      "sort": [1776816000000, "ZH_BK_004_MJ240016-L_2026-04-22"]
    }
  ],
  "next_cursor": [1772668800000, "ZH_BK_004_MJ240004-L_2026-03-05"],
  "aggregations": null
}

Setzt case_number automatisch in Anführungszeichen und sucht als exakte Phrase. Ansonsten identisch zu search — gleiche Filter, gleiche Antwortstruktur.

Eingabe

Ausgabe

Identisch zu search: total, hits, next_cursor, aggregations.

Beispiel

// Aufruf
{ "case_number": "BGE 142 III 1", "size": 1 }

// Antwort (gekürzt)
{
  "total": 171,
  "hits": [
    {
      "id": "CH_BGE_005_BGE-142-III-1_2016",
      "title": "Bundesgericht (BGE) Teil III 2016 BGE 142 III 1",
      "abstract": "Regeste a … Art. 85 Abs. 1 IPRG; Art. 5 HKsÜ …",
      "canton": "CH",
      "court": "CH_BGE",
      "decision_date": "2016-01-01",
      "is_pdf": false,
      "document_url": "https://entscheidsuche.ch/docs/CH_BGE/CH_BGE_005_BGE-142-III-1_2016.html",
      "sort": [50.027256, "CH_BGE_005_BGE-142-III-1_2016"]
    }
  ],
  "next_cursor": [50.027256, "CH_BGE_005_BGE-142-III-1_2016"]
}

Liefert einen einzelnen Entscheid anhand seiner Dokument-ID — im Unterschied zur Suche mit dem vollständigen Volltext in text (nicht nur einem Highlight-Auszug).

Eingabe

Ausgabe

Beispiel

// Aufruf
{ "id": "CH_BGE_005_BGE-142-III-1_2016" }

// Antwort (gekürzt)
{
  "result": {
    "id": "CH_BGE_005_BGE-142-III-1_2016",
    "title": "Bundesgericht (BGE) Teil III 2016 BGE 142 III 1",
    "abstract": "Regeste a … Zuteilung der alleinigen elterlichen Sorge …",
    "text": "Urteilskopf\n\n142 III 1\n\n1. Auszug aus dem Urteil der II. zivilrechtlichen Abteilung …",
    "meta": "Eidgenossenschaft Bundesgericht (BGE) Teil III",
    "canton": "CH",
    "court": "CH_BGE",
    "decision_date": "2016-01-01",
    "scrape_date": "2023-01-01",
    "is_pdf": false,
    "document_url": "https://entscheidsuche.ch/docs/CH_BGE/CH_BGE_005_BGE-142-III-1_2016.html",
    "original_url": null,
    "sort": null
  }
}

Liefert die Hierarchie-IDs für Kantone, Gerichte und Kammern mit Trefferzahlen. Die IDs werden im hierarchy-Filter von search verwendet. Mit query beziehen sich die Zahlen auf die Treffer dieser Anfrage.

Eingabe

Ausgabe

Beispiel

// Aufruf
{ "query": "Mietrecht", "size": 4 }

// Antwort
{
  "entries": [
    { "id": "CH",          "count": 736 },
    { "id": "CH_BGer",     "count": 503 },
    { "id": "ZH",          "count": 485 },
    { "id": "CH_BGer_004", "count": 444 }
  ]
}

Hierarchischer Facettenbaum mit lokalisierten Bezeichnungen. Anders als list_hierarchy ohne Trefferzahlen, dafür mit Klartext-Namen in mehreren Sprachen. Die id-Werte sind im hierarchy-Filter verwendbar.

Eingabe

Keine Parameter.

Ausgabe

Beispiel

// Aufruf
{}

// Antwort (Auszug — ein Knoten je Listeneintrag)
{
  "id": "CH",
  "label": {
    "de": "Eidgenossenschaft",
    "fr": "Conféderation",
    "it": "Confederazione",
    "en": null
  },
  "children": []
}
{
  "id": "AG",
  "label": { "de": "Aargau", "fr": "Argovie", "it": "Argovia", "en": null },
  "children": []
}

Diagnose-Endpunkt: Version des Servers und die konfigurierten Upstream-URLs. Nützlich, um zu prüfen, welche Version tatsächlich läuft.

Eingabe

Keine Parameter.

Ausgabe

Beispiel

// Aufruf
{}

// Antwort
{
  "name": "entscheidsuche-mcp",
  "version": "0.1.1",
  "elasticsearch_url": "https://entscheidsuche.pansoft.de:9200/entscheidsuche.v2-*/_search",
  "facets_url": "https://entscheidsuche.ch/docs/Facetten.json",
  "languages": ["de", "fr", "it"],
  "sort_orders": ["relevance", "date", "scrapedate"]
}

Diese Struktur liefern search und search_by_case_number in hits[] sowie fetch_document in result.