LexGraph MCP Dokumentation

Verbindung und Authentifizierung

LexGraph stellt einen zustandslosen Streamable-HTTP-Endpunkt bereit. Anfragen und Antworten werden als JSON übertragen; der Produktionsendpunkt streamt keine SSE-Fortschrittsmeldungen.

MCP URL: https://api.lexgraph.de/mcp

Transport

MCP Streamable HTTP

Authentifizierung

OAuth 2.0 oder MCP-Key

OAuth-Scope

mcp

Antwortmodus

eine JSON-Antwort pro Request

OAuth 2.0 (empfohlen)

OAuth-fähige Clients verbinden sich über dynamische Client-Registrierung und Authorization Code mit PKCE. Der Client übernimmt Registrierung, Tokenaustausch und Erneuerung automatisch.

1. Fügen Sie die MCP-URL als benutzerdefinierten Remote-MCP-Server in Ihrem Client hinzu.
2. Wählen Sie OAuth 2.0 mit dynamischer Client-Registrierung, sofern der Client danach fragt.
3. Melden Sie sich bei LexGraph an und bestätigen Sie die Verbindung.
4. Nach der Rückleitung lädt der Client die aktuelle LexGraph-Tool-Liste.

MCP-Key (für Header-Auth)

Clients ohne OAuth können einen persönlichen MCP-Key verwenden. Erstellen Sie den Key im LexGraph-Profil und senden Sie ihn im Header Authorization: Bearer <MCP_KEY>. Der vollständige Key wird nur einmal angezeigt; Rotation widerruft den vorherigen Key, setzt aber das Kontingent nicht zurück.

Verfügbare Tools

lexgraph_search_legal_graph

Erstellt serverseitig ein fertiges juristisches Memorandum mit LexGraph-Permalinks und verbindlichem Verbatim-Vertrag.

lexgraph_search_legal_graph_enriched

Erstellt dasselbe Memorandum und liefert zusätzlich die tatsächlich zitierten Entitäten als Hintergrundkontext für spätere Nachfragen.

lexgraph_search_legal_data

Recherchiert mit denselben Engine-Pfaden, erzeugt aber keine Antwort. Bei einer eindeutig bezeichneten Gerichtsentscheidung enthält deren description die verfügbaren Volltextabschnitte.

lexgraph_get_capabilities

Liefert Schema-Version, serverseitige Suchpfade, tarifabhängige Datenquellen, Filterwerte, Grenzen und Idempotenzvertrag.

lexgraph_get_mcp_usage

Liefert den aktuellen Tarif- und Kontingentstand, ohne selbst Kontingent zu verbrauchen.

Alle fünf Tools sind schreibgeschützt, nicht destruktiv und auf öffentliche LexGraph-Daten begrenzt. Diagnose- und Entwicklungsoptionen bleiben auf die lokale Admin-Preview beschränkt. Unbekannte Argumente werden abgelehnt.

Parameter und Rückgaben

lexgraph_search_legal_graph

lexgraph_search_legal_graph_enriched

lexgraph_search_legal_data

lexgraph_get_capabilities

Keine Parameter. Rückgabe: schema_version, die Suchpfade lexgraph_legal_agent, lexgraph_cases und lexgraph_entity, tarifabhängige Datenquellen, search.filters mit Filterwerten und Grenzen, feste Engine-Limits sowie der request_id-/Idempotenzvertrag. Dieses Tool verbraucht kein Recherchekontingent.

lexgraph_get_mcp_usage

Keine Parameter. Rückgabe: Tarif sowie limit, remaining, used und reset_at des Recherchekontingents. Der Abruf verbraucht kein Kontingent.

Rückgabe der Suche

• LexGraph Memorandum liefert answer und direkt danach response_contract mit mode=verbatim, Ausgabeanweisung, Zitationsstandard und SHA-256-Prüfsumme.
• LexGraph Memorandum Enriched ergänzt searchable_entities. Dieses Feld ist nur Hintergrundkontext und darf nicht sichtbar an answer angehängt werden.
• LexGraph Legal Data liefert trace_id, original_query, search_mode, count, entities, quota_charged und usage, aber kein answer.
• Bei einem eindeutigen Direktabruf einer Gerichtsentscheidung enthält die description der primären Entität die verfügbaren Abschnitte wie Leitsätze, Tenor, Tatbestand und Entscheidungsgründe.
• Norm-Entitäten können book, slug und prefix_category enthalten; auflösbare Quellen enthalten zitierfertige Markdown-Permalinks.
• Interne Reranking-Scores, Diagnosewerte und lokale Entwicklungsoptionen werden nicht öffentlich zurückgegeben.

Optionale Filter

Alle drei Recherchetools akzeptieren dasselbe filters-Objekt wie die API. Der Assistent setzt es nur bei ausdrücklich gewünschten Einschränkungen, leitet keine zusätzlichen Filter aus dem Kontext ab und übernimmt query weiterhin unverändert.

• Alle vier Felder sind optional. Werte innerhalb einer Liste werden mit ODER, verschiedene anwendbare Felder mit UND verknüpft.
• Gerichtsentscheidungen unterstützen alle vier Felder, Gesetze Rechtsgebiet und Region, Konzepte nur das Rechtsgebiet. Gericht und Zeitraum schließen Gesetze und Konzepte nicht aus.
• Bei aktiven Filtern werden EU-Rechtsakte und europäische Entscheidungen derzeit ausgeschlossen. Die Abdeckung des Landesrechts entspricht der API.
• Filter gelten in allen Suchpfaden, auch für Einzelabrufe und nachgeladene Quellen. Leere Ergebnisse führen nicht zu einer automatischen Lockerung.
• Unbekannte Felder, ungültige Regionen und ungültige Datumsintervalle werden vor Suche und Kontingentverbrauch abgelehnt.
• lexgraph_get_capabilities liefert unter search.filters die unterstützten Regionen, empfohlenen Rechtsgebiete und Gerichtscodes sowie die aktuellen Grenzen.

Suchmodi, Collections und Tarife

Nicht im Tarif enthaltene Collections werden serverintern gefiltert. Bleibt dadurch keine Collection übrig, schlägt der Aufruf fehl.

Weitere technische Kontolimits

• 30 Requests pro Minute
• 1.000 Requests pro Tag
• 2.000.000 Anfragezeichen pro Monat
• maximal 20.000 Zeichen pro Anfrage
• Rechercheumfang und Kandidatenzahl werden serverseitig festgelegt

Beispielaufrufe

Funktionen des aktuellen Kontos prüfen

{}

Memorandum mit sicherer Wiederholungs-ID

{
  "query": "Welche arbeitsrechtlichen Entscheidungen des BAG seit 2020 sind relevant?",
  "request_id": "search-20260928-001",
  "filters": {
    "rechtsgebiete": [
      "Arbeitsrecht"
    ],
    "gerichte": [
      "BAG"
    ],
    "zeitraum": {
      "von": "2020-01-01"
    }
  }
}

Kontingente und sichere Wiederholungen

• Recherchen in der LexGraph Engine und erfolgreiche MCP-Suchen verwenden dasselbe Kontingent des Nutzerkontos.
• Der Free-Testzugang umfasst Gesetze, Rechtsprechung, Kommentare, Nachweise und Agentic Search (Memorandum) mit insgesamt 25 gemeinsamen Rechercheanfragen in Engine und MCP. Neue Konten erhalten zehn Tage ab Kontoerstellung, bereits bestehende Konten zehn Tage ab Einführung des Testmodells. Zahlungsdaten sind nicht erforderlich. Nach Ablauf des Testzeitraums oder Verbrauch des Kontingents sind weitere KI-Recherchen nur mit einem kostenpflichtigen Tarif möglich. Der Test endet automatisch und wird nicht automatisch in ein kostenpflichtiges Abonnement umgewandelt. Die manuelle Suche in der frei zugänglichen Rechtsdatenbank bleibt kostenlos.
• Eine erfolgreiche Suche verbraucht einen Rechercheaufruf aus dem gemeinsamen Recherchekontingent sowie normale Request- und Zeichen-Nutzung. Fehlgeschlagene Suchen werden nicht belastet. Das nächste Rücksetzdatum steht in reset_at.
• Tarifrechte und Kontingent werden bei jedem Aufruf serverintern durchgesetzt; capabilities und usage liefern dazu ausschließlich lesende Status-Snapshots.
• request_id ist für die Suche optional. Derselbe Wert mit identischen Parametern wird innerhalb von acht Tagen nicht doppelt belastet; derselbe Wert mit anderen Parametern einschließlich aktiver Filter wird abgelehnt. Listenreihenfolge und normalisierte Regionsschreibweisen ändern den Wiederholungsvergleich nicht.
• Kontingente sind an das Nutzerkonto gebunden. Das Rotieren eines MCP-Keys setzt sie nicht zurück.

Fehler und Fehlercodes

• HTTP 401: Authentifizierung fehlt, ist ungültig oder abgelaufen.
• HTTP 403: Erforderlicher Scope oder Kontozugriff fehlt.
• JSON-RPC -32601: Unbekanntes oder entferntes Tool.
• JSON-RPC -32602: Ungültige Parameter, unbekannte Felder oder nicht unterstützte Werte.
• Tool-Fehler: Kontingent überschritten, Tarif erlaubt Modus/Collection nicht, request_id-Konflikt oder interner Retrieval-Fehler. Tool-Fehler sind nicht zwingend HTTP-Fehler.

Datenschutz und Datenverwendung

Die Anonymisierung von MCP-Suchanfragen ist derzeit deaktiviert. Die validierte Anfrage wird an die konfigurierten Such- und Modellanbieter weitergegeben. LexGraph verarbeitet außerdem die übergebenen Filter und weitere Parameter zur Recherche. Die Konto-ID dient der Zugriffskontrolle, Nutzungsanalyse und Kontingentberechnung. MCP-Tools laden keine Dokumente hoch, greifen nicht auf private Nutzerdokumente zu und verändern den Wissensgraphen nicht. Das MCP-HTTP-Profiling erfasst technische Metadaten, aber weder die Recherchefrage noch Authentifizierungstokens; separate Rechercheprotokolle können die Anfrage und Ergebnisse enthalten.

Bekannte Einschränkungen

• Memorandum und Memorandum Enriched liefern eine fertige Antwort; nur bei Legal Data formuliert der verbundene Assistent selbst.
• Die Abdeckung hängt vom aktuell in LexGraph vorhandenen Material ab und kann unvollständig sein.
• Suchmodus, Quellen, Zerlegung, Kandidatenzahl und Reranking werden in Version 3.1.0 ausschließlich serverseitig gewählt und sind keine öffentlichen Tool-Argumente.
• Nur der eindeutige Direktabruf einer Entscheidung über Legal Data kann die verfügbaren Volltextabschnitte in description liefern; eine allgemeine Rechtsprechungssuche garantiert keinen vollständigen Entscheidungstext.
• searchable_entities ist beim Enriched-Tool ausschließlich maschinenlesbarer Hintergrundkontext und darf nicht zusätzlich zur fertigen Antwort ausgegeben werden.
• Fortschritt wird intern erst nach 45 Sekunden gemeldet; der JSON-Produktionsendpunkt streamt diese Meldungen nicht an HTTP-Clients.
• Die Ergebnisse sind Recherchehilfen und ersetzen keine professionelle rechtliche Prüfung.

Changelog

3.1.0 · 28 September 2026

• Optionales filters-Objekt bei Memorandum, Memorandum Enriched und Legal Data ergänzt; dieselben Werte und dieselbe Validierung wie in der API.
• Filter werden nur bei ausdrücklich gewünschten Einschränkungen gesetzt und in allen Suchpfaden angewendet.
• Aktive Filter fließen normalisiert in den request_id-Vergleich ein. Wiederholungen ohne Filter bleiben kompatibel.
• Capabilities beschreiben Filterwerte und Grenzen. Nach dem Update die Tool-Liste im MCP-Client neu laden; bestehende Aufrufe ohne Filter bleiben gültig.

3.0.0 · 21 August 2026

• Der öffentliche MCP verwendet jetzt dieselben Implementierungsfunktionen wie die interne Answer-Preview; Preview und Veröffentlichung besitzen damit einen gemeinsamen Ausführungspfad.
• Der öffentliche Vertrag umfasst fünf schreibgeschützte Tools: Memorandum, Memorandum Enriched, Legal Data, Capabilities und Usage.
• Mit Version 3.0.0 akzeptierten die drei Recherchetools nur query und optional request_id; Version 3.1.0 ergänzt filters. Der Client muss die ursprüngliche Nutzernachricht 1:1 übergeben; Suchmodus, Quellen, Zerlegung, Limits und Reranking werden serverseitig bestimmt.
• Memorandum liefert answer plus einen kryptografisch prüfbaren response_contract und verlangt die unveränderte Ausgabe. Enriched ergänzt nur die tatsächlich zitierten searchable_entities; Legal Data liefert Entitäten ohne fertige Antwort.
• Automatisches Routing verwendet lexgraph_legal_agent, lexgraph_cases oder lexgraph_entity. Die alten clientseitigen Modi und Rechercheparameter gehören nicht mehr zum öffentlichen v3-Schema.
• Norm-Treffer können book, slug und prefix_category enthalten; Permalinks und zitierfähige Metadaten bleiben Teil der serialisierten Entitäten.
• Rohdiagnostik und Entwicklungssteuerung bleiben in der geschützten lokalen Preview; die dort getesteten Standardpfade sind jedoch dieselben Funktionen, die /mcp ausführt.

2.3.1 · 19 August 2026

• Das Standardlimit der MCP-Suche wurde von 40 auf 30 Treffer angepasst.

2.3.0 · 19 August 2026

• Die Suchmodus-Auswahl wurde auf embeddings, graph_search und agentic_search reduziert.
• Graph Search übernimmt Standard-Routing und Retrieval-Fallbacks.

2.2.2 · 18 August 2026

• Das Standardlimit der MCP-Suche wurde von 20 auf 40 Treffer erhöht.

2.2.1 · 18 August 2026

• embeddings ist jetzt der Standardmodus für die MCP-Suche; graph_search bleibt explizit auswählbar.

2.2.0 · 14 August 2026

• lexgraph_get_capabilities liefert unter search.filters.recommended_values die vollständigen aktuellen Empfehlungen für Rechtsgebiete und standardisierte Gerichtscodes.
• Die Empfehlungen bleiben offen für zukünftige oder datenbankspezifische Werte und werden nicht als geschlossene Eingabe-Enums validiert.

2.1.0 · 14 August 2026

• Das optionale filters-Objekt mit Rechtsgebiet, Region, Gericht und Zeitraum ergänzt.
• Quellenbezogene AND-/OR-Semantik sowie Landesrecht über konfigurierte Arango Views dokumentiert.
• EU-Rechtsakte und europäische Entscheidungen bei aktiven Filtern vorerst ausgeschlossen.

2.0.1 · 1 August 2026

• lexgraph_get_capabilities und den Schema-Vertrag 2.0.1 ergänzt.
• Expliziter Schema-Default limit=20; ein kleinerer Wert soll nur bei entsprechendem Nutzerwunsch verwendet werden.
• Tarifabhängige Collections, Agentic-Verfügbarkeit und gemeinsame Recherchekontingente dokumentiert.
• request_id, quota_charged, effektive Parameter und Rückgabeverträge ergänzt.

2.0.0 · 1 August 2026

• Vier Suchmodi, Quality-Control-Verhalten und strikte Parameterschemas eingeführt.
• Optionale Relationships dokumentiert.
• Frühere Answer- und Reference-Extraction-Tools entfernt.

Support

Technische Fragen und Störungsmeldungen beantwortet unser MCP-Support über office@lexgraph.de.