Referenz

MCP-Werkzeuge

knowmind stellt 15 MCP-Werkzeuge über JSON-RPC 2.0 unter https://knowmind.de/api/mcp/v1 bereit. Diese Referenz dokumentiert jede Signatur, jeden Parameter, das Rückgabe-Schema, ein vollständiges Beispiel und die typischen Fehlerfälle. MCP-Protokoll-Version: 2025-06-18.

Allgemeines

Endpunkt: POST https://knowmind.de/api/mcp/v1
Authentifizierung: Authorization: Bearer kmt_…
Inhalt: JSON-RPC-2.0-Request mit method: "tools/call" und Parametern in params.arguments.
Antwort-Format: JSON-RPC-Response. Bei Accept: text/event-stream liefert der Endpunkt Streamable-HTTP-Frames (SSE) — für native Custom-Connectoren in Claude.ai und ChatGPT.
Scope-Modell: read genügt für Recall- und List-Werkzeuge; write für Anlage und Pflege; admin für Tarif-relevante Aktionen. Scopes werden serverseitig pro Tool-Call geprüft.
Tenant-Isolation: Ein Token gehört genau zu einem Arbeitsbereich. Für die abgefragten Inhalte prüft die Datenbank bei jeder Abfrage, zu welchem Arbeitsbereich eine Zeile gehört.

knowmind_recall

Scope: readseit 0.3.0

Hybrid-Recall gegen den Wissenskorpus Ihres Arbeitsbereichs. Kombiniert Volltext (BM25 mit deutschem Analyzer), Vektor (multilingual-e5-large, 1024 Dimensionen) und eine Suche im Wissensgraphen. Cross-Encoder-Rerank für die Top-Treffer. Die Antwort beginnt mit dem Feld kein_belastbarer_treffer. Steht es auf true, hat der Bestand auf die Frage sehr wahrscheinlich keine Antwort; ein englischer Text im Feld hinweis sagt das, die Treffer kommen trotzdem mit. Das Kennzeichen ist eine Schätzung aus Rerank-Wert und Begriffsabdeckung, kein Beweis.

Parameter

Name	Typ	Pflicht	Default	Hinweis
query	string	ja	—	Natürlichsprachliche Frage
k	integer	nein	5	Anzahl Treffer (1 bis 25)
hops	integer	nein	2	Wird angenommen (0 bis 3) und wirkt derzeit nicht auf den Abruf.

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowmind_recall",
    "arguments": {
      "query": "Wer ist Ansprechpartnerin für die Einarbeitung?",
      "k": 5,
      "hops": 2
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "kein_belastbarer_treffer": false,
    "hits": [
      {
        "memory_id": "memory_einarbeitung_2026_03",
        "title": "Einarbeitungs-Verantwortliche Q2 2026",
        "content": "Anna Müller ist Ansprechpartnerin für die Einarbeitung neuer Service-Mitarbeitender, vertreten durch Tomasz Kowalski.",
        "score": 0.93,
        "source": "internal-handbook-v3"
      }
    ],
    "elapsed_ms": 187
  }
}

Fehlerfälle

Code	Bedeutung
-32602	Invalid params (query fehlt oder leer)
-32000	Service-Token unconfigured oder Anbieter-Fehler
401	Bearer-Token fehlt oder ungültig
-32004	Fragegrenze erreicht — Wartezeit steht in message

knowmind_recall_at_time

Scope: readseit 0.3.0

Punkt-in-Zeit-Recall (bi-temporal). Liefert ausschließlich Erinnerungen, die zum angegebenen Zeitpunkt gültig waren — also valid_from kleiner-gleich as_of und (valid_to größer as_of oder valid_to ungesetzt). Geeignet für die Frage „Was wusste der Wissensspeicher am 14. März?“. Auch hier steht kein_belastbarer_treffer vorn, beurteilt an den Treffern, die zum Stichtag as_of sichtbar sind.

Parameter

Name	Typ	Pflicht	Default	Hinweis
query	string	ja	—	Natürlichsprachliche Frage
as_of	string (ISO 8601)	nein	now	Zeitpunkt der Gültigkeit, z. B. 2026-03-14T00:00:00Z
k	integer	nein	5	Anzahl Treffer (1 bis 25)

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "knowmind_recall_at_time",
    "arguments": {
      "query": "Tarif-Stand Müller GmbH",
      "as_of": "2026-03-14T00:00:00Z",
      "k": 3
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "kein_belastbarer_treffer": false,
    "hits": [
      {
        "memory_id": "memory_mueller_tarif_v2",
        "title": "Tarif Müller GmbH ab 01.02.2026",
        "content": "Müller GmbH läuft auf Tarif Business mit fünf Plätzen.",
        "valid_from": "2026-02-01T00:00:00Z",
        "valid_to": "2026-04-01T00:00:00Z",
        "score": 0.88
      }
    ]
  }
}

Fehlerfälle

Code	Bedeutung
-32602	Invalid params (query fehlt, as_of nicht ISO 8601)
-32004	Fragegrenze erreicht — Wartezeit steht in message
401	Bearer-Token fehlt oder ungültig

knowmind_list_relations

Scope: readseit 0.3.0

Liefert alle ein- und ausgehenden typisierten Beziehungen einer Erinnerung. Pro Beziehung: Typ, Quell- und Ziel-Knoten, Anlage-Zeitpunkt.

Parameter

Name	Typ	Pflicht	Default	Hinweis
memory_id	string	ja	—	ID der Erinnerung, deren Beziehungen abgefragt werden

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "knowmind_list_relations",
    "arguments": { "memory_id": "memory_workshop_2026_03_12" }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "outgoing": [
      { "rel_type": "FOR_CLIENT", "to": "memory_mueller_kunde" },
      { "rel_type": "REFERENCES", "to": "memory_qm_handbuch" }
    ],
    "incoming": [
      { "rel_type": "SUPERSEDES", "from": "memory_workshop_2026_03_19" }
    ]
  }
}

Fehlerfälle

Code	Bedeutung
-32602	Invalid params (memory_id fehlt)
404	Erinnerung nicht gefunden

knowmind_list_inferred

Scope: readseit 10.10.2026

Listet Beziehungen, die auf eine Entscheidung warten: aus Text erschlossene (Grund inferred_from_text) und solche, die von einem Dokument ausgehen, obwohl ihre Art eine Person, Organisation oder Ähnliches verlangt (Grund starts_from_document). Pro Beziehung: edge_id, Typ, Zustand (open, confirmed, rejected), Grund, beide Einträge, die Herkunft (source, etwa die Extraktion) und der belegende Eintrag (evidence); dazu die Zahl je Zustand. Offene Beziehungen fließen erst nach der Bestätigung in Ableitungsregeln ein.

Parameter

Name	Typ	Pflicht	Default	Hinweis
status	string	nein	—	open, confirmed oder rejected; ohne Angabe alle Zustände
limit	integer	nein	—	1 bis 200, Vorgabe 50
offset	integer	nein	—	Zahl der Beziehungen, die übersprungen werden

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": { "name": "knowmind_list_inferred", "arguments": { "status": "open", "limit": 20 } }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "counts": { "open": 12, "confirmed": 3, "rejected": 1 },
    "relations": [
      { "edge_id": "5:a1b2:3301", "rel_type": "WORKS_FOR", "state": "open",
        "from": { "id": "entity-maria", "name": "Maria Keller" },
        "to": { "id": "entity-northwind", "name": "Northwind Studio" },
        "source": "claude-extract", "evidence": "memory_kickoff_notes" }
    ]
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Recht fehlt: read

knowmind_review_inferred

Scope: writeseit 10.10.2026

Hält eine Entscheidung zu einer erschlossenen Beziehung fest. confirm: Die Beziehung fließt ab jetzt in Ableitungsregeln ein. reject: Die Beziehung, ihre Gegenrichtung und alle daraus abgeleiteten Beziehungen bekommen valid_to; gelöscht wird nichts. undo: nimmt eine Ablehnung zurück, samt Gegenrichtung und abgeleiteten Beziehungen. Liefert den Zustand vorher und nachher und die Zahl der betroffenen Gegenrichtungen und abgeleiteten Beziehungen.

Parameter

Name	Typ	Pflicht	Default	Hinweis
edge_id	string	ja	—	edge_id aus knowmind_list_inferred
decision	string	ja	—	confirm, reject oder undo
evidence	string	nein	—	ID des Eintrags, der die Entscheidung stützt

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": { "name": "knowmind_review_inferred", "arguments": { "edge_id": "5:a1b2:3301", "decision": "reject" } }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "edge_id": "5:a1b2:3301",
    "before": { "state": "open", "valid_to": null },
    "after": { "state": "rejected", "valid_to": "2026-10-10T04:40:00+02:00" },
    "derived_relations_affected": 1
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Recht fehlt: write
404	Die Beziehung steht nicht in der Prüfliste dieses Arbeitsbereichs
409	Entscheidung im jetzigen Zustand nicht möglich, etwa eine abgelehnte Beziehung bestätigen, ohne die Ablehnung zurückzunehmen

knowmind_health

Scope: —seit 0.1.0

Liefert Service-Status. Erreichbar mit jedem Token. Keine Tenant-Daten.

Parameter

Name	Typ	Pflicht	Default	Hinweis
Keine Parameter

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": { "name": "knowmind_health", "arguments": {} }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "status": "ok",
    "service": "memory",
    "version": "0.3.0"
  }
}

Fehlerfälle

Code	Bedeutung
503	Service nicht erreichbar (Memory-Service, Postgres oder Graph)

knowmind_stats

Scope: readseit 0.2.0

Aktuelle Korpus-Statistik für den Arbeitsbereich des Tokens: Anzahl Erinnerungen, Anzahl Beziehungen, Anzahl Chunks im Vektor-Index.

Parameter

Name	Typ	Pflicht	Default	Hinweis
Keine Parameter

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": { "name": "knowmind_stats", "arguments": {} }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "memories": 1219,
    "edges": 5512,
    "chunks": 3214
  }
}

Fehlerfälle

Code	Bedeutung
401	Bearer-Token fehlt oder ungültig

knowmind_list_recent

Scope: readseit 0.4.0

Listet die zuletzt angelegten Dokumente und Erinnerungen des Arbeitsbereichs, sortiert nach Anlagedatum absteigend (created_at). Quelle ist der Dokument-Korpus — dieselbe Basis, die der Recall durchsucht. Graph-Entitäten ohne Zeitstempel erscheinen nicht; die Anzahl weicht darum bewusst von knowmind_stats (memories) ab.

Parameter

Name	Typ	Pflicht	Default	Hinweis
k	integer	nein	10	Anzahl der neuesten Einträge (1 bis 50)

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "knowmind_list_recent",
    "arguments": { "k": 3 }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 11,
  "result": {
    "items": [
      {
        "id": "5a3c9f2e-1b7d-4c21-9e0a-8f6d2b3c4e5f",
        "title": "Einarbeitungs-Handbuch v3",
        "status": "indexed",
        "indexed_chunks": 23,
        "created_at": "2026-06-10T07:12:44Z",
        "updated_at": "2026-06-10T07:12:51Z",
        "kind": "document"
      }
    ],
    "count": 1
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Scope read fehlt
401	Bearer-Token fehlt oder ungültig

knowmind_store_memory

Scope: writeseit 0.2.0

Legt eine neue Erinnerung dauerhaft im Arbeitsbereich an: Postgres-Dokument, Vektor-Index und Graph-Knoten. Danach ist der Eintrag per knowmind_recall und knowmind_list_recent auffindbar. Append-only: Einträge gleichen Titels werden NICHT ersetzt — Versionierung übernimmt knowmind_update_fact. Sha-identischer Inhalt wird idempotent erkannt (Antwortfeld unchanged). Für längere Texte mit Upsert-per-Titel ist knowmind_upload_document das richtige Werkzeug.

Parameter

Name	Typ	Pflicht	Default	Hinweis
title	string	nein	—	Kurz-Titel der Erinnerung
content	string	ja	—	Vollständiger Text
memory_type	string (enum)	nein	semantic	semantic, episodic, procedural, reference
tags	string[]	nein	—	Schlagworte für Filterung
source	string	nein	—	Quelle, frei-text

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "knowmind_store_memory",
    "arguments": {
      "title": "QM-Schulung Pflicht",
      "content": "Alle Service-Mitarbeitenden absolvieren die QM-Schulung jährlich.",
      "memory_type": "procedural",
      "tags": ["qm","schulung"],
      "source": "internal-handbook"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "memory_id": "5a3c9f2e-1b7d-4c21-9e0a-8f6d2b3c4e5f",
    "id": "5a3c9f2e-1b7d-4c21-9e0a-8f6d2b3c4e5f",
    "title": "QM-Schulung Pflicht",
    "status": "indexed",
    "chunks_written": 1,
    "embedding_provider": "fastembed"
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Scope write fehlt
-32603	content_required (content fehlt oder leer), too_large (Inhalt über 1.000.000 Zeichen), ingest_failed (Memory-Service-Fehler — nichts wird vorgetäuscht, der Eintrag bleibt als failed markiert)
401	Bearer-Token fehlt oder ungültig

knowmind_upload_document

Scope: writeseit 0.2.0

Ingestet einen längeren Text dauerhaft als Dokument. knowmind teilt den Text in Abschnitte, erzeugt pro Abschnitt einen Vektor und legt einen Graph-Knoten an. Upsert-per-Titel (Server-Default): Existiert im selben Bereich bereits ein Dokument gleichen Titels, löst die neue Version die alte ab. Die alte bleibt über knowmind_recall_at_time zu früheren Stichtagen abrufbar, gelöscht wird nichts; die abgelösten IDs stehen in replaced_document_ids. Steht derselbe Text schon in einem anderen gültigen Dokument desselben Bereichs, legt knowmind kein neues an; die Antwort nennt dessen ID in memory_id und trägt deduplicated.

Parameter

Name	Typ	Pflicht	Default	Hinweis
title	string	nein	—	Dokument-Titel
content	string	ja	—	Volltext des Dokuments
source	string	nein	—	Herkunftsangabe (URL, Pfad); entscheidet nicht, welches Dokument abgelöst wird
replace	boolean	nein	true	false legt ausdrücklich ein neues Dokument neben dem Dokument gleichen Titels an

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "knowmind_upload_document",
    "arguments": {
      "title": "Einarbeitungs-Handbuch v3",
      "content": "Kapitel 1 — Onboarding-Ablauf …",
      "source": "internal-handbook-v3.md"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "memory_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "title": "Einarbeitungs-Handbuch v3",
    "status": "indexed",
    "chunks_written": 23,
    "embedding_provider": "fastembed",
    "replaced_document_ids": ["1f2e3d4c-5b6a-4d7c-9e8f-a0b1c2d3e4f5"]
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Scope write fehlt
-32603	content_required (content fehlt oder leer), too_large (Inhalt über 1.000.000 Zeichen), ingest_failed (Memory-Service-Fehler)
401	Bearer-Token fehlt oder ungültig

knowmind_update_fact

Scope: writeseit 0.3.0

Bitemporale Aktualisierung einer bestehenden Erinnerung: das Original bekommt valid_to gleich jetzt, eine neue Version mit valid_from gleich jetzt wird angelegt und per SUPERSEDES-Beziehung verknüpft. Damit bleibt die Historie prüfbar: Alte Aussagen bleiben erhalten und werden als überholt markiert.

Parameter

Name	Typ	Pflicht	Default	Hinweis
target_id	string	ja	—	ID der zu aktualisierenden Erinnerung
new_title	string	ja	—	Titel der neuen Version
new_content	string	ja	—	Inhalt der neuen Version
update_reason	string	nein	—	Begründung, z. B. „Adresse geändert“

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "tools/call",
  "params": {
    "name": "knowmind_update_fact",
    "arguments": {
      "target_id": "memory_mueller_adresse_v1",
      "new_title": "Anschrift Müller GmbH ab 01.06.2026",
      "new_content": "Müller GmbH, Industriestraße 7, 32756 Detmold.",
      "update_reason": "Adresse geändert zum 01.06.2026"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "old_memory_id": "memory_mueller_adresse_v1",
    "new_memory_id": "memory_mueller_adresse_v2",
    "supersedes_edge": "edge_supersedes_2026_05_23"
  }
}

Fehlerfälle

Code	Bedeutung
-32602	Invalid params (Pflichtfeld fehlt)
404	target_id nicht gefunden
403	Scope write fehlt

knowmind_end_fact

Scope: writeseit 19.10.2026

Beendet einen Eintrag, der nicht mehr gilt und den nichts ersetzt, etwa nach dem Abschluss eines Projekts oder wenn eine Quelle zurückgezogen wurde. Der Eintrag bekommt valid_to und fällt aus knowmind_recall; knowmind_recall_at_time findet ihn zu einem früheren Zeitpunkt weiter. Gelöscht wird nichts, ein neuer Eintrag entsteht nicht. Ein zweiter Aufruf ändert nichts.

Parameter

Name	Typ	Pflicht	Default	Hinweis
target_id	string	ja	—	ID des Eintrags, aus knowmind_recall
valid_to	string	nein	—	Zeitpunkt mit Zeitzone, ab dem der Eintrag nicht mehr gilt; ohne Angabe jetzt
reason	string	nein	—	Grund, z. B. „Quelle zurückgezogen“

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "tools/call",
  "params": {
    "name": "knowmind_end_fact",
    "arguments": {
      "target_id": "3f6c2a1e-8b7d-4c11-9a52-0d4e8f2b7c90",
      "valid_to": "2026-10-11T22:10:00+02:00",
      "reason": "Quelle zurückgezogen"
    }
  }
}

Beispiel — Antwort

json

{
  "document_id": "3f6c2a1e-8b7d-4c11-9a52-0d4e8f2b7c90",
  "titel": "Projektordner: Lagerliste",
  "gueltig_bis": "2026-10-11T20:10:00+00:00",
  "abschnitte": 3,
  "knoten": 1,
  "schon_beendet": false
}

Fehlerfälle

Code	Bedeutung
-32002	Scope write fehlt
400	valid_to ohne Zeitzone oder keine gültige Kennung
404	target_id nicht gefunden
409	Eintrag ist schon durch eine neue Fassung abgelöst

knowmind_link

Scope: writeseit 0.3.0

Legt eine typisierte Beziehung zwischen zwei Erinnerungen an. Inverse-Beziehung wird automatisch materialisiert. Zulässige Edge-Typen siehe Referenz Beziehungstypen.

Parameter

Name	Typ	Pflicht	Default	Hinweis
from_id	string	ja	—	Memory-ID des Quell-Knotens
to_id	string	ja	—	Memory-ID des Ziel-Knotens
rel_type	string	ja	—	Edge-Typ in UPPER_SNAKE_CASE (z. B. OWNS, FOR_CLIENT, SUPERSEDES)

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "tools/call",
  "params": {
    "name": "knowmind_link",
    "arguments": {
      "from_id": "memory_workshop_2026_03_12",
      "to_id":   "memory_mueller_kunde",
      "rel_type": "FOR_CLIENT"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "edge_id": "edge_for_client_2026_05_23",
    "inverse_edge_id": "edge_has_workshop_2026_05_23"
  }
}

Fehlerfälle

Code	Bedeutung
-32602	Invalid params
400	SHACL-Constraint verletzt (z. B. unzulässiger rel_type für die Domain)
404	from_id oder to_id nicht gefunden

knowmind_unlink

Scope: writeseit 0.3.0

Beendet eine Beziehung samt Gegenrichtung. Der Abruf zu einem früheren Zeitpunkt findet sie.

Parameter

Name	Typ	Pflicht	Default	Hinweis
from_id	string	ja	—	Memory-ID des Quell-Knotens
to_id	string	ja	—	Memory-ID des Ziel-Knotens
rel_type	string	ja	—	Edge-Typ

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "knowmind_unlink",
    "arguments": {
      "from_id": "memory_workshop_2026_03_12",
      "to_id":   "memory_mueller_kunde",
      "rel_type": "FOR_CLIENT"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": { "deleted": 1, "inverse_deleted": 1, "folgekanten": 0, "beendet_am": "2026-10-17T03:35:45.117565+00:00" }
}

Fehlerfälle

Code	Bedeutung
400	Unbekannter Kantentyp

knowmind_entity

Scope: writeseit 15.08.2026

Legt den Knoten für ein Ding an, über das der Bestand spricht — eine Person, eine Organisation, eine Anwendung, einen Rechner, eine Technik — oder gibt den vorhandenen zurück. Gleicher Name, gleiche Klasse und gleicher Arbeitsbereich liefern immer dieselbe ID; ein zweiter Aufruf legt keine Dublette an. Verbunden wird der Knoten danach mit knowmind_link.

Parameter

Name	Typ	Pflicht	Default	Hinweis
name	string	ja	—	Eigenname, wie er in einem Dokument stünde. Keine Rolle, kein Status, keine Beschreibung.
entity_class	string	ja	—	Klasse aus dem Katalog (knowmind_schema → entityClasses), z. B. Person, Organization, Application, Host, Technology
description	string	nein	—	Ein Satz, was das ist
aliases	string[]	nein	—	Weitere Schreibweisen

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "knowmind_entity",
    "arguments": {
      "name": "PostgreSQL",
      "entity_class": "Technology"
    }
  }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 11,
  "result": {
    "id": "…",
    "name": "PostgreSQL",
    "entity_class": "Technology",
    "created": true
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Missing scope: write
-32602	Invalid params

knowmind_schema

Scope: readseit 15.08.2026

Gibt den Beziehungskatalog des Arbeitsbereichs zurück: jede erlaubte Beziehung mit Subjekt- und Objektklasse und einer Erklärung, wann sie passt, dazu die Klassen für knowmind_entity. Vor knowmind_link aufrufen, damit die richtige Beziehung gewählt wird.

Parameter

Name	Typ	Pflicht	Default	Hinweis
Keine Parameter

Beispiel — Anfrage

json

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": { "name": "knowmind_schema", "arguments": {} }
}

Beispiel — Antwort

json

{
  "jsonrpc": "2.0",
  "id": 12,
  "result": {
    "entityClasses": ["…"],
    "predicates": ["…"],
    "hinweis": "Pick the predicate whose subject and object classes match your two nodes. …"
  }
}

Fehlerfälle

Code	Bedeutung
-32002	Missing scope: read