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, 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 serverseitigen Suchpfade lexgraph_legal_agent, lexgraph_cases und lexgraph_entity, tarifabhängige Datenquellen, feste Engine-Grenzen 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.

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-20260821-001"
}

Kontingente und sichere Wiederholungen

• Recherchen in der LexGraph Engine und erfolgreiche MCP-Suchen verwenden dasselbe Kontingent des Nutzerkontos.
• Im Free-Tarif stehen insgesamt 25 Rechercheaufrufe bereit. Neue Konten erhalten zehn Tage ab Kontoerstellung, bereits bestehende Konten zehn Tage ab Einführung des Testmodells. Danach sind keine weiteren Recherchen möglich.
• Eine erfolgreiche Suche verbraucht einen Rechercheaufruf aus dem gemeinsamen Wochenkontingent sowie normale Request- und Zeichen-Nutzung. Fehlgeschlagene Suchen werden nicht belastet. Das Wochenkontingent wird montags zurückgesetzt.
• 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 wird abgelehnt.
• 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

MCP-Suchanfragen werden vor der Recherche lokal auf dem LexGraph-Server anonymisiert. Personen, Adressen, E-Mail-Adressen und weitere strukturierte Identifikatoren werden erkannt und durch typisierte Platzhalter ersetzt. Dafür wird kein externer PII-Dienst aufgerufen; nur die bereinigte Anfrage wird an die nachfolgenden Suchschritte übergeben. LexGraph verarbeitet außerdem ausgewählte Parameter und Aktenzeichen zur Ausführung des Tools. Die Konto-ID dient der Zugriffskontrolle, Analyse der Tool-Nutzung und Kontingentberechnung. MCP-Tools laden keine Dokumente hoch, greifen nicht auf private Nutzerdokumente zu und verändern den Wissensgraphen nicht. Das MCP-HTTP-Profiling protokolliert unter anderem Zeitstempel, Toolname, Status, Laufzeiten, Antwortgröße und gegebenenfalls request_id, aber weder die Recherchefrage noch das Authentifizierungstoken. Senden Sie keine Zugangstokens oder geheimen Schlüssel an den Support.

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.0.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.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.
• Alle drei Recherchetools akzeptieren nur query und optional request_id. 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.
• Die lokale Anonymisierung erfolgt vor Idempotenz-Fingerprint und Recherche. Für Kontolimits zählt weiterhin die Länge der ursprünglichen Anfrage; bei einem Anonymisierungsfehler startet keine Suche.
• 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 Wochenkontingente 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.