MCP-API — Entwickler-Dokumentation

Öffentliche Doku des Verifact-MCP-Servers (Model Context Protocol).

Überblick

Der Verifact-MCP-Server stellt verifiziertes Wissen aus dem signierten Wissens-Ledger über das Model Context Protocol (MCP) bereit. Die Kommunikation erfolgt über JSON-RPC 2.0 / Streamable HTTP.

protocolVersion 2024-11-05 JSON-RPC 2.0 Streamable HTTP

Endpunkt
https://api.verifact.network/mcp
Authentifizierung
Bearer-JWT (tenant-gebunden) für tools/call. Die Tool-Dokumentation (tools/list) ist öffentlich und ohne Token abrufbar.
Maschinenlesbare Tool-Liste
GET /v1/mcp-tools (JSON).

Bereichs-Landkarte

Der Ledger umfasst u. a.: DE-Recht (~133k Normen), Rechtsprechung (~108k, inkl. Landesgerichte), EU-Recht, Sanktionslisten, SEALED-Steuer-/Lohn-Berechnungen, OECD/Finanzen/Wirtschaft, IT-Security, CODATA-Physik, Chemie, Astronomie, Biologie und ISO.

Werkzeuge (Tools)

verifact_ask

Stellt eine Frage und liefert verifiziertes Wissen. Ausgabe u. a.: answer, trust_pct, regime (NONE / OBSERVED / NORM / RECHTSPRECHUNG / SEALED / QUOTA), match_similaritaet (roher Cosinus 0..1; < 0,72 = schwacher Treffer), weitere_normen, verweise, aktualitaet und beleg (signiert).

Frage-Vorlage: präzise Einzelfrage stellen und dabei Fachvokabular sowie konkrete Identifikatoren (Norm-/Aktenzeichen, IDs) nennen.

Ehrliche Grenze: Bei legal_calc liefert verifact_ask die nächstgelegene bereits versiegelte Berechnung — keine Live-Rechnung auf beliebige Zahlen. regime=NONE mit trust_pct=0 ist eine ehrliche Wissenslücke, keine erfundene Antwort.

verifact_ground

Liefert eine signierte Begründungskette vom Phänomen bis zum SEALED-Axiom (Grounding-DAG).

verifact_document

Liefert Volltext und Metadaten on-demand anhand einer Fundstelle oder ID.

verifact_graph

Read-only Bulk-Export von Knoten und Kanten des Wissensgraphen. Paginiert (cursor/limit), Delta-Abruf (since) sowie Filter über regime und sealed_only.

verifact_history

Fassungshistorie je canonical_key mit asof-Stichtag (bitemporal).

verifact_pruefe_zitate

Prüft die in einem Dokument zitierten Normen gegen den Ledger — Existenz, Aktualität und abgelöste Fassung — und stellt eine signierte Quittung aus. Arbeitet LLM-frei.

Beispiel: POST /v1/ask

POST /v1/ask HTTP/1.1
Host: api.verifact.network
Authorization: Bearer <JWT>
Content-Type: application/json

{
  "frage": "Wie hoch ist der gesetzliche Verzugszinssatz für Entgeltforderungen zwischen Unternehmern nach § 288 Abs. 2 BGB?"
}

Beispielhafte, signierte Antwort:

{
  "answer": "9 Prozentpunkte über dem Basiszinssatz (§ 288 Abs. 2 BGB).",
  "trust_pct": 100,
  "regime": "NORM",
  "match_similaritaet": 0.91,
  "weitere_normen": ["§ 288 Abs. 1 BGB", "§ 247 BGB"],
  "verweise": ["gii:bgb/288"],
  "aktualitaet": "Fassung gültig zum Abrufzeitpunkt",
  "beleg": {
    "signatur": "ed25519:…",
    "hash": "sha256:…"
  }
}

Maschinenlesbare Tool-Definitionen: GET /v1/mcp-tools.