Skip to content

PLANIT-TECH/lawbster-mcp

Repository files navigation

Lawbster — Verifizierter, zitierfähiger Rechtskontext für jeden KI-Assistenten

Lawbster — Deutsches & EU-Recht für jeden KI-Assistenten

Verifizierter, zitierfähiger Rechtskontext via Model Context Protocol. Claude · ChatGPT · Cursor · Copilot · jeder MCP-fähige Client.

Website NPM MCP GDPR Made in Germany License: MIT

Quickstart · Tools · Skills & Rules · Coverage · English


KI halluziniert bei Rechtsfragen. Lawbster liefert die Fakten.

Ohne Lawbster:

❌ "§ 823a BGB regelt die Haftung bei Schmerzensgeld …" (diesen Paragrafen gibt es nicht) ❌ "Art. 9 DSGVO erlaubt die Verarbeitung mit Einwilligung — Stand 2023" (Trainings-Cutoff, ggf. veraltet) ❌ "Der BGH entschied in VI ZR 999/22 …" (ausgedachtes Aktenzeichen)

Mit Lawbster:

§ 253 Abs. 2 BGB — Volltext, Stand 2024-10-01, Direkt-URL zur amtlichen Quelle ✅ Art. 9 Abs. 2 lit. a DSGVO — Volltext mit Hierarchie-Pfad ✅ BGH VI ZR 175/22 vom 2023-05-15 — Tenor + zitierte Normen

Lawbster ist ein produktionsreifer MCP-Server, der KI-Assistenten verifizierten Zugriff auf das deutsche und europäische Recht gibt — täglich aktualisiert aus amtlichen Quellen, durchsuchbar mit dreistufiger Hybrid-Suche, jeder Treffer mit exakter Fundstelle. Stand: MRR@10 = 0,676 auf dem öffentlichen GerLeRB-Benchmark.


⚡ Quickstart in 60 Sekunden

Endpunkt: https://lawbster.planitprima.com/mcp (Streamable HTTP, Bearer-Auth oder OAuth 2.1)

# Variante 1 — npx-Setup (alle Clients, einfachster Weg)
npx -y @planit-lawbster/lawbster-mcp setup --client claude
# unterstützt: claude | cursor | vscode | windsurf

# Variante 2 — manueller Eintrag (siehe Client-Sektionen unten)

API-Key holen: lawbster.planitprima.com → 14 Tage kostenlos testen, keine Kreditkarte. Klartext erscheint genau einmal beim Erstellen — direkt in den Client kopieren.


🔧 Setup pro Client

Claude Desktop (macOS / Windows / Linux)

Config-Datei:

Plattform Pfad
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json

Eintrag:

{
  "mcpServers": {
    "lawbster": {
      "type": "http",
      "url": "https://lawbster.planitprima.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-legal-DEIN-API-KEY"
      }
    }
  }
}

Claude Desktop vollständig beenden (Quit, nicht nur Fenster schließen) und neu öffnen. Das MCP-Icon zeigt jetzt Lawbster mit acht Tools.

Test-Prompt: „Was sind die Voraussetzungen für eine Schmerzensgeldforderung nach § 253 BGB? Bitte mit Quellenangabe."

Troubleshooting:

  • Lawbster erscheint nicht → JSON-Syntax prüfen mit python -m json.tool < claude_desktop_config.json. Häufiger Fehler: fehlendes Komma zwischen mehreren Servern.
  • 401 Unauthorized → Token-Prefix sk-legal- korrekt? Subscription aktiv?
  • 429 Rate-Limit → 60 Anfragen/Minute pro Seat. Lange Recherche-Sessions können das treffen — zweiten Seat zubuchen oder kurz pausieren.
Cursor (Composer / Agent)

Ein-Klick-Install:

🖱️ Add Lawbster to Cursor

Nach Klick: API-Key (sk-legal-…) im Cursor-Config-Editor anstelle von YOUR_LAWBSTER_API_KEY eintragen.

Manuell: .cursor/mcp.json im Projekt-Root oder ~/.cursor/mcp.json global:

{
  "mcpServers": {
    "lawbster": {
      "type": "http",
      "url": "https://lawbster.planitprima.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LAWBSTER_TOKEN}"
      }
    }
  }
}

Wichtig: Token nie ins Repo committen — .cursor/mcp.json in .gitignore, oder Token via Umgebungsvariable beziehen (siehe Snippet oben).

Anwendungsfälle:

  • AGB-Generierung mit echten BGB-Klauseln (§§ 305–310, § 309 Nr. 7)
  • DSGVO-Compliance-Check beim Schreiben von Datenverarbeitungs-Code (Art. 6, Art. 9 DSGVO)
  • KI-VO-Risikoklassifikation beim Bau von ML-Pipelines

→ Empfohlen: Cursor-Rule kopieren, damit Cursor Lawbster automatisch bei rechtlichen Fragen nutzt.

ChatGPT (Pro / Team / Enterprise) und Claude.ai (Web)

Browser-Clients sprechen MCP nativ über OAuth 2.1 — kein Code, kein Klartext-Token im Browser-Storage.

ChatGPT:

  1. SettingsConnectorsAdd custom connector
  2. Name: Lawbster
  3. MCP Server URL: https://lawbster.planitprima.com/mcp
  4. Authentication: OAuth
  5. Save → Browser-Tab → Lawbster-Login → Allow
  6. Im Chat: Tools-Dropdown → Lawbster aktivieren

Claude.ai:

  1. SettingsConnectorsAdd custom
  2. Name: Lawbster
  3. Remote MCP server URL: https://lawbster.planitprima.com/mcp
  4. Sign in → Lawbster-Login → Allow
  5. Im Chat: Tools-Icon → Lawbster aktivieren

💡 Claude.ai unterstützt auch MCP Resourceslegal://rechtsrahmen und Co. erscheinen als attachable references im Chat.

Seats und OAuth: Jedes OAuth-Subject = ein Seat (selbe subject_id, auch wenn du es in beiden Clients nutzt).

Custom-GPT-System-Prompt: Wenn du einen Custom-GPT mit Lawbster baust, kopiere den vorgefertigten System-Prompt — er erzwingt Tool-Nutzung und Citation-Pflicht.

Copilot Studio (Microsoft 365 / Power Platform / Teams)

Copilot Studio unterstützt MCP-Server als „Custom Connectors" und zieht — anders als viele andere Clients — auch Resources, was für Lawbster (legal://rechtsrahmen, legal://eu_celex_registry) besonders wertvoll ist.

Pfad A — OAuth (empfohlen):

  1. ToolsAdd a toolNew toolModel Context Protocol
  2. Server URL: https://lawbster.planitprima.com/mcp
  3. Authentication: OAuth 2.0. Endpoints (Authorization-URL, Token-URL, Scopes) bekommst du von uns — Mail an support@planitprima.com, wir tragen die Redirect-URI deines Tenants nach.
  4. Save & Test → Lawbster-Login → Allow

Pfad B — API-Key (Server-to-Server-Bots):

  1. ToolsNew toolModel Context Protocol
  2. Server URL: https://lawbster.planitprima.com/mcp
  3. Authentication: Bearer
  4. Token: sk-legal-…

Anwendungsfälle:

  • Compliance-Bot in Teams — DSGVO-Anfragen mit zitierten Artikeln
  • Vertragsprüfung in Word — markierte Klausel → einschlägige BGB-Paragrafen
  • Power Apps für Inhouse-Counsel — Low-Code-App mit Rechtskorpus
VS Code (Copilot Chat) / Windsurf / Zed / Cline / generischer HTTP-MCP-Client

Jeder Client mit Streamable-HTTP-MCP-Support funktioniert. Allgemeines Setup:

{
  "mcpServers": {
    "lawbster": {
      "type": "http",
      "url": "https://lawbster.planitprima.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-legal-DEIN-API-KEY"
      }
    }
  }
}

Konfig-Pfad pro Client:

Client Pfad
VS Code (Copilot Chat) .vscode/mcp.json (workspace) oder Settings UI
Windsurf Settings → MCP Servers
Zed ~/.config/zed/settings.jsoncontext_servers
Cline VS Code Settings → Cline → MCP Servers

Eigene App: MCP Python SDK oder TypeScript SDK. Endpunkt + Bearer-Token, mehr braucht es nicht.

Test ohne Client:

curl -X POST https://lawbster.planitprima.com/mcp \
  -H "Authorization: Bearer sk-legal-..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

🛠️ Tools

Acht Tools, alle batch-fähig, alle async, alle zitierfähig. Discovery-Tools liefern kompakte Antworten (~4 k Token), Detail-Tools volle Texte. Standard-Pagination via count / total / offset / has_more / next_offset / hint.

Tool Zweck Kategorie
legal_search Hybrid-Suche mit AI-Reranking + Filter Discovery
legal_lookup Volltext einer Norm per Zitat Detail
legal_lookup_batch Bis zu 20 Lookups in einem Call Detail
legal_get_context Umgebende Normen einer Fundstelle Detail
legal_find_citing_decisions Bundesgerichtsentscheidungen zu einer Norm Detail
legal_list_laws Verfügbare Gesetze auflisten Discovery
legal_get_toc Inhaltsverzeichnis eines Gesetzes Discovery
legal_get_stats Index- und Datenbankstatistiken Discovery

Beispiel — legal_search

{
  "tool": "legal_search",
  "arguments": {
    "query": "Schmerzensgeld bei Persönlichkeitsverletzung",
    "top_k": 5
  }
}

Liefert §§ 823, 253 BGB plus einschlägige BGH-Entscheidungen — gemischt, gerankt nach Relevanz, nicht nach Quelltyp.

Beispiel — legal_lookup

{
  "tool": "legal_lookup",
  "arguments": { "citation": "Art. 6 Abs. 1 lit. a DSGVO" }
}

Liefert den exakten Buchstaben mit Hierarchie-Pfad und Stand.

Akzeptierte Zitierformen: § 823 BGB, § 1 Abs. 1 GG, § 280 Abs. 1 Satz 1 BGB, Art. 6 Abs. 1 lit. a DSGVO, Art. 5 Abs. 1 EU 2024/1689, C-311/18, BGH VI ZR 175/22, BVerfG 1 BvR 16/13.

Vollständige Tool-Referenz mit allen Parametern, Beispielen und Response-Schemas


🧩 MCP Resources & Prompts

Neben Tools liefert Lawbster sechs Resources und drei Prompts.

Resources

URI Zweck Quota
legal://rechtsrahmen Domain → einschlägige Gesetze (Datenschutz → DSGVO+BDSG+TTDSG; Versicherung → VVG, nicht BGB) Frei
legal://filter_values Gültige Filter-Werte für legal_search Frei
legal://eu_celex_registry Kuratierte CELEX-IDs für EU-Rechtsakte Frei
legal://norm/{norm_id} Volltext einer Einzelnorm als Resource Pro-Seat
legal://law/{source_type}/{abbreviation} Inhaltsverzeichnis eines Gesetzes Pro-Seat
legal://eu/celex/{celex} EU-Rechtsakt per CELEX-ID Pro-Seat

Prompts (Slash-Commands)

Command Zweck
/legal_research Strukturierte Recherche mit Fußnoten-Zitaten, Pflicht zur Tool-Nutzung
/citation_resolve Einzelnes Zitat → verifizierter Volltext
/compare_de_eu DE- und EU-Regelung gegenüberstellen + Verhältnis benennen (Umsetzung/Goldplating/…)

Verfügbar in Claude Desktop, Claude.ai, Copilot Studio.


🪄 Skills & Rules

Vorgefertigte Snippets, die deinem KI-Client beibringen, wann und wie er Lawbster nutzen soll. Copy-paste, fertig.

Asset Zielsystem Zweck
rules/cursor.md Cursor (.cursor/rules/) Trigger-Rule: bei §, BGB, DSGVO, Urteil → Lawbster aufrufen, immer Citation, nie halluzinieren
skills/legal-research/ Claude Code Skill mit YAML-Frontmatter: 5-Schritt-Workflow für saubere Rechtsrecherche
prompts/chatgpt-custom-gpt.md ChatGPT Custom-GPT System-Prompt + Citation-Pflicht analog Skill
prompts/copilot-instructions.md GitHub Copilot (.github/copilot-instructions.md) Repo-weite Anweisung: Lawbster für rechtliche Fragen verwenden

Die mitgelieferten MCP-Prompts (/legal_research, /citation_resolve, /compare_de_eu) decken denselben Workflow server-seitig ab — nutze sie in MCP-fähigen Clients (Claude Desktop, Claude.ai, Copilot Studio); die client-seitigen Skills/Rules sind die Variante für Clients ohne native Prompt-Unterstützung.


📚 Was Lawbster abdeckt

Quelle Inhalt Aktualität
Bundesrecht BGB, ZPO, HGB, AktG, GmbHG, StGB, StPO, AO, EStG, KStG, UStG, SGB I–XII, KSchG, ArbZG, MiLoG, AGG, BetrVG, TVG, BDSG, … Täglich
EU-Recht DSGVO, KI-VO, MiCA, DORA, NIS2, DSA, DMA, Data Act, Data Governance Act, Verordnungen, Richtlinien, Beschlüsse Täglich
EuGH-Rechtsprechung Verfahrensnummern wie C-311/18, T-451/20 Täglich
Bundesgerichte BGH, BVerfG, BAG, BSG, BPatG, BFH Täglich

Vollständiges deutsches Bundesrecht · vollständiges EU-Recht · Bundesgerichtsentscheidungen · jede Norm einzeln zitierbar. Alle Inhalte aus amtlichen, frei zugänglichen Quellen — keine Verlagslizenz, keine Drittanbieter-Daten, keine intransparente Lizenzkette.

Stabiler Reverse-Index: Welche Norm wurde von welcher Entscheidung zitiert? Treibt das Tool legal_find_citing_decisions.

Was nicht drin ist: Kommunalrecht, berufsständisches Recht, Lehrmeinungen, Kommentarliteratur, Fachzeitschriften (verlagslizenziert) — Lawbster ist die Basis-Schicht, kombinierbar mit deiner Verlagslizenz.


🎯 Warum Lawbster?

Gegenüber LLM-Direktnutzung: Kein Trainings-Cutoff. Exakte Paragrafen statt geraten. Jede Antwort mit Fundstelle. Sauber getrennt zwischen BGB / DSGVO / BGH-Urteilen. KI halluziniert bei Rechtsfragen regelmäßig — mit Lawbster nicht mehr.

Gegenüber anderen Legal-MCP-Servern: Produktionsreif statt Hobby-Projekt. Hybrid-Suche mit AI-Reranking (öffentlicher Benchmark). Pro-Seat-Quota, OAuth + API-Key, kommerzieller Support, tägliche Aktualisierung aus amtlichen Quellen.

Gegenüber Komplett-KI-Lösungen (Harvey, Noxtua): Lawbster ist die darunterliegende Schicht — der zitierfähige Rechtskontext-Provider. Eigenes LLM, eigener Workflow. Wie Context7, aber für Recht.


🔒 Compliance & Sicherheit

  • Hosting in Deutschland — alle Daten ausschließlich auf Hetzner-Servern in Deutschland verarbeitet und gespeichert
  • DSGVO-konform — Auftragsverarbeitungsvertrag (AVV) nach Art. 28 DSGVO inklusive
  • Keine personenbezogenen Daten im Regelbetrieb — der Index enthält nur öffentliche Rechtstexte; Tool-Call-Inhalte werden nicht persistiert
  • API-Keys SHA-256-gehasht — Klartext nur einmal beim Erstellen sichtbar
  • Dual-Auth — API-Key (sk-legal-…) für Server-to-Server, OAuth 2.1 mit JWT für Web-Clients
  • Pro-Seat-Quota mit Fair-Use-Limit (60 Anfragen/min)
  • Stripe für Zahlungsabwicklung unter EU-US Data Privacy Framework (Art. 45 DSGVO)

→ Verbindliches in AGB und Datenschutzerklärung.


💰 Pricing

Ein Plan, klare Abrechnung. 19 € pro Seat / Monat. 14 Tage kostenlos testen, keine Kreditkarte, jederzeit kündbar. Vollständiger Rechtskorpus inklusive.

lawbster.planitprima.com/pricing


📖 Weitere Doku


🤝 Beitrag & Support

Pull Requests an die Doku sind willkommen — Tippfehler, fehlende Beispiele, neue Quickstart-Guides für weitere MCP-Clients. Code-Contributions am npm-Wrapper-Paket (packages/lawbster-mcp/) ebenfalls.


📜 License

Code und Dokumentation in diesem Repo: MIT License.

Der Lawbster-Server-Quellcode ist nicht Open Source — Lawbster ist ein gemanagter SaaS-Dienst, betrieben von PLANIT // TECH GmbH in Deutschland.


⚠️ Disclaimer

Lawbster liefert verifizierte Rechtsinformation, keine Rechtsberatung im Sinne des RDG. Für eine konkrete Rechtsberatung wende dich an eine Rechtsanwältin oder einen Rechtsanwalt. Treffer aus dem Lawbster-Index ersetzen keine juristische Auswertung im Einzelfall.


© 2026 PLANIT // TECH GmbH · Impressum · Datenschutz · AGB