DRGSystem — German medical coding catalogs

SEG-4-Kodierempfehlung abrufen

seg4kde_get

Read-onlyIdempotent

Liefert in 'focus' den Volltext einer SEG-4-Kodierempfehlung samt Veröffentlichungs- und Änderungsdatum sowie den darin genannten ICD-, OPS- und DRG-Kodes. Ohne Nummer aufgerufen liefert die Funktion die oberste Gliederungsebene.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`code`	No	Nummer der Kodierempfehlung. Leer lassen für die oberste Gliederungsebene.
`year`	No	Katalogjahr (z. B. 2026). Leer lassen für das aktuellste verfügbare Jahr.

Output Schema

TableJSON Schema

Name	Required	Description
`year`	No	Katalogjahr, aus dem alle Daten dieser Antwort stammen.
`focus`	No	Der abgefragte Kode mit allen Detaildaten. Null bei einer Suche und beim Katalog-Einstieg (leerer Kode).
`items`	No	Die Kodeliste der Antwort: bei einer Abfrage die direkt untergeordneten Kodes von 'focus' (bzw. die oberste Ebene bei leerem Kode), bei einer Suche die Treffer.
`parents`	No	Übergeordnete Kodes von 'focus' als Pfad von der obersten Ebene abwärts (Brotkrumen). Leer bei einer Suche und beim Katalog-Einstieg.
`interpretation`	No	Nur bei einer Suche: wie die Suche die Anfrage gelesen hat. Null außerhalb der Suche.

Schema Changelog

Changes observed during successful MCP inspections.

Changed12 schema fields changedSep 28, 2026

addedOutput schema / properties / focus / properties / change

Added value: +{
+  "description": "Was sich an dieser Empfehlung seit dem vorherigen Abruf der Datenbank geändert hat. Null, wenn nichts oder kein Vergleich vorliegt.",
+  "properties": {
+    "fields": {
+      "description": "Geänderte Teile: Text, Schlagwort, ICD, OPS, DRG, Aktualisiert, Schlichtung.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "kind": {
+      "description": "neu oder geändert.",
+      "type": "string"
+    },
+    "since": {
+      "description": "Stand des vorherigen Abrufs (yyyy-MM-dd), mit dem verglichen wurde.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / foka

Added value: +{
+  "description": "Position des FoKA der DGfM zu dieser Empfehlung: Konsens, Konsens mit Kommentar oder Dissens, mit Datum und Link.",
+  "properties": {
+    "position": {
+      "description": "Position: 'Konsens', 'Konsens mit Kommentar', 'Dissens'.",
+      "type": "string"
+    },
+    "stand": {
+      "description": "Stand der Position (yyyy-MM-dd), falls angegeben.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "url": {
+      "description": "Seite mit der Stellungnahme.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "von": {
+      "description": "Wer Stellung nimmt, z. B. 'FoKA'.",
+      "type": "string"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

changedOutput schema / properties / focus / properties / icd / description

Previous value: -"In der Empfehlung genannte ICD-Kodes, gegen den ICD-Katalog aufgelöst."New value: +"ICD-Kodes, auf die sich die Empfehlung bezieht (Feld ICD der Empfehlung), gegen den ICD-Katalog aufgelöst."

addedOutput schema / properties / focus / properties / icdMentioned

Added value: +{
+  "description": "ICD-Kodes, die nur im Text der Empfehlung erwähnt werden (Abgrenzung, Beispiel, Verweis).",
+  "items": {
+    "$ref": "#/properties/focus/properties/drg/items"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

changedOutput schema / properties / focus / properties / ops / description

Previous value: -"In der Empfehlung genannte OPS-Kodes, gegen den OPS-Katalog aufgelöst."New value: +"OPS-Kodes, auf die sich die Empfehlung bezieht (Feld OPS der Empfehlung), gegen den OPS-Katalog aufgelöst."

addedOutput schema / properties / focus / properties / opsMentioned

Added value: +{
+  "description": "OPS-Kodes, die nur im Text der Empfehlung erwähnt werden (Abgrenzung, Beispiel, Verweis).",
+  "items": {
+    "$ref": "#/properties/focus/properties/drg/items"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / schlichtungGiltAb

Added value: +{
+  "description": "Ab diesem Aufnahmedatum (yyyy-MM-dd) gilt die Schlichtungsentscheidung (§ 19 Abs. 4 KHG: erster Tag des übernächsten Monats nach Veröffentlichung); außerdem für Rechnungen, die bei Veröffentlichung schon in MD-Prüfung waren.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / schlichtungPublished

Added value: +{
+  "description": "Datum (yyyy-MM-dd), an dem der Schlichtungsausschuss Bund seine Entscheidung zu dieser Empfehlung veröffentlicht hat. Eine so entschiedene Empfehlung ist für Krankenhäuser, Kassen und MD gleichermaßen verbindlich. Null, wenn es keine Entscheidung gibt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / sourceDate

Added value: +{
+  "description": "Stand der Quelle (yyyy-MM-dd): an diesem Tag wurde die Datenbank der Kodierempfehlungen abgerufen.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

changedOutput schema / properties / items / items / properties / icd / description

Previous value: -"In der Empfehlung genannte ICD-Kodes, gegen den ICD-Katalog aufgelöst."New value: +"ICD-Kodes, auf die sich die Empfehlung bezieht (Feld ICD der Empfehlung), gegen den ICD-Katalog aufgelöst."

changedOutput schema / properties / items / items / properties / ops / description

Previous value: -"In der Empfehlung genannte OPS-Kodes, gegen den OPS-Katalog aufgelöst."New value: +"OPS-Kodes, auf die sich die Empfehlung bezieht (Feld OPS der Empfehlung), gegen den OPS-Katalog aufgelöst."

addedOutput schema / properties / items / items / properties / schlichtungPublished

Added value: +{
+  "description": "Datum (yyyy-MM-dd) der Entscheidung des Schlichtungsausschusses Bund zu dieser Empfehlung. Null, wenn es keine gibt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed4 schema fields changedSep 16, 2026

removedOutput schema / properties / focus / properties / descriptionHighlight

Removed value: -{
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description' — wie wörtlich die Suchanfrage das jeweilige Wort getroffen hat. 1,00 das Wort selbst, 0,75 eine Wortform oder ein Präfix, 0,50 ein Bestandteil eines zusammengesetzten Wortes, 0,25 ein Synonym oder ein korrigierter Tippfehler. Null, wenn die Anfrage diesen Text nicht berührt hat. Über MCP immer null.",
-  "items": {
-    "type": "number"
-  },
-  "type": [
-    "array",
-    "null"
-  ]
-}

removedOutput schema / properties / focus / properties / matchedTermHighlight

Removed value: -{
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'matchedTerm', gleiche Skala wie 'descriptionHighlight'. Über MCP immer null.",
-  "items": {
-    "type": "number"
-  },
-  "type": [
-    "array",
-    "null"
-  ]
-}

removedOutput schema / properties / items / items / properties / descriptionHighlight

Removed value: -{
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description' — wie wörtlich die Suchanfrage das jeweilige Wort getroffen hat. 1,00 das Wort selbst, 0,75 eine Wortform oder ein Präfix, 0,50 ein Bestandteil eines zusammengesetzten Wortes, 0,25 ein Synonym oder ein korrigierter Tippfehler. Null, wenn die Anfrage diesen Text nicht berührt hat. Über MCP immer null.",
-  "items": {
-    "type": "number"
-  },
-  "type": [
-    "array",
-    "null"
-  ]
-}

removedOutput schema / properties / items / items / properties / matchedTermHighlight

Removed value: -{
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'matchedTerm', gleiche Skala wie 'descriptionHighlight'. Über MCP immer null.",
-  "items": {
-    "type": "number"
-  },
-  "type": [
-    "array",
-    "null"
-  ]
-}

Changed15 schema fields changedSep 13, 2026

changedOutput schema / properties / focus / properties / descriptionHighlight / description

Previous value: -"Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description'. Über MCP immer null."New value: +"Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description' — wie wörtlich die Suchanfrage das jeweilige Wort getroffen hat. 1,00 das Wort selbst, 0,75 eine Wortform oder ein Präfix, 0,50 ein Bestandteil eines zusammengesetzten Wortes, 0,25 ein Synonym oder ein korrigierter Tippfehler. Null, wenn die Anfrage diesen Text nicht berührt hat. Über MCP immer null."

addedOutput schema / properties / focus / properties / groupCode

Added value: +{
+  "description": "Nur bei einer Suche: die Rubrik, unter der die Suche diesen Treffer einordnet — beim ICD die dreistellige Kategorie, beim OPS der vierstellige Kode. Die Liste bleibt flach; wer mag, gruppiert danach. Null außerhalb der Suche.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / isGroupHeader

Added value: +{
+  "description": "Nur bei einer Suche: True, wenn diese Zeile die Rubrik selbst ist und die folgenden Zeilen mit gleichem 'groupCode' ihre Kodes sind.",
+  "type": "boolean"
+}

addedOutput schema / properties / focus / properties / isSemanticMatch

Added value: +{
+  "description": "Nur bei einer Suche: True, wenn kein Wort der Anfrage diesen Kode erreicht hat und er über die Bedeutung gefunden wurde. Dann gibt es nichts hervorzuheben.",
+  "type": "boolean"
+}

addedOutput schema / properties / focus / properties / matchedTerm

Added value: +{
+  "description": "Nur bei einer Suche: die Formulierung, über die der Treffer gefunden wurde, wenn sie etwas sagt, was 'description' nicht sagt — etwa der Eintrag des Alphabetischen Verzeichnisses, unter dem der Kode nachgewiesen ist. Null, wenn der Treffer sich aus der Bezeichnung selbst erklärt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / focus / properties / matchedTermHighlight

Added value: +{
+  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'matchedTerm', gleiche Skala wie 'descriptionHighlight'. Über MCP immer null.",
+  "items": {
+    "type": "number"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

changedOutput schema / properties / focus / properties / treeDepth / description

Previous value: -"Nur wenn die Liste ein aufgeklapptes Teilbaum-Listing ist: Tiefe dieser Zeile innerhalb der Liste (0 = direkt unter dem abgefragten Kode, 1 = dessen Kind usw.). Null bedeutet, dass die Zeilen der Liste in keinem Über-/Unterordnungsverhältnis zueinander stehen — etwa bei einer Suche."New value: +"Nur wenn die Liste ein aufgeklapptes Teilbaum-Listing ist: Tiefe dieser Zeile innerhalb der Liste (0 = direkt unter dem abgefragten Kode, 1 = dessen Kind usw.). Bei einer Suche null — dort sagt 'groupCode', wohin eine Zeile gehört, und die Gliederung entsteht durch Blöcke statt durch Einrückung."

addedOutput schema / properties / interpretation

Added value: +{
+  "description": "Nur bei einer Suche: wie die Suche die Anfrage gelesen hat. Null außerhalb der Suche.",
+  "properties": {
+    "detectedCode": {
+      "description": "Im Suchtext erkannte Schlüsselnummer, normalisiert (z. B. 'I219', '5820'). Null, wenn die Anfrage nur Text war.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "expandedTerms": {
+      "description": "Aufgelöste Abkürzungen, mit denen zusätzlich gesucht wurde — etwa 'KHK' auch als 'Koronare Herzkrankheit'.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "usedSemanticSearch": {
+      "description": "True, wenn die Wortsuche keinen sicheren Treffer hatte und zusätzlich nach Bedeutung gesucht wurde.",
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

changedOutput schema / properties / items / items / properties / descriptionHighlight / description

Previous value: -"Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description'. Über MCP immer null."New value: +"Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'description' — wie wörtlich die Suchanfrage das jeweilige Wort getroffen hat. 1,00 das Wort selbst, 0,75 eine Wortform oder ein Präfix, 0,50 ein Bestandteil eines zusammengesetzten Wortes, 0,25 ein Synonym oder ein korrigierter Tippfehler. Null, wenn die Anfrage diesen Text nicht berührt hat. Über MCP immer null."

addedOutput schema / properties / items / items / properties / groupCode

Added value: +{
+  "description": "Nur bei einer Suche: die Rubrik, unter der die Suche diesen Treffer einordnet — beim ICD die dreistellige Kategorie, beim OPS der vierstellige Kode. Die Liste bleibt flach; wer mag, gruppiert danach. Null außerhalb der Suche.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / items / items / properties / isGroupHeader

Added value: +{
+  "description": "Nur bei einer Suche: True, wenn diese Zeile die Rubrik selbst ist und die folgenden Zeilen mit gleichem 'groupCode' ihre Kodes sind.",
+  "type": "boolean"
+}

addedOutput schema / properties / items / items / properties / isSemanticMatch

Added value: +{
+  "description": "Nur bei einer Suche: True, wenn kein Wort der Anfrage diesen Kode erreicht hat und er über die Bedeutung gefunden wurde. Dann gibt es nichts hervorzuheben.",
+  "type": "boolean"
+}

addedOutput schema / properties / items / items / properties / matchedTerm

Added value: +{
+  "description": "Nur bei einer Suche: die Formulierung, über die der Treffer gefunden wurde, wenn sie etwas sagt, was 'description' nicht sagt — etwa der Eintrag des Alphabetischen Verzeichnisses, unter dem der Kode nachgewiesen ist. Null, wenn der Treffer sich aus der Bezeichnung selbst erklärt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / items / items / properties / matchedTermHighlight

Added value: +{
+  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'matchedTerm', gleiche Skala wie 'descriptionHighlight'. Über MCP immer null.",
+  "items": {
+    "type": "number"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

changedOutput schema / properties / items / items / properties / treeDepth / description

Previous value: -"Nur wenn die Liste ein aufgeklapptes Teilbaum-Listing ist: Tiefe dieser Zeile innerhalb der Liste (0 = direkt unter dem abgefragten Kode, 1 = dessen Kind usw.). Null bedeutet, dass die Zeilen der Liste in keinem Über-/Unterordnungsverhältnis zueinander stehen — etwa bei einer Suche."New value: +"Nur wenn die Liste ein aufgeklapptes Teilbaum-Listing ist: Tiefe dieser Zeile innerhalb der Liste (0 = direkt unter dem abgefragten Kode, 1 = dessen Kind usw.). Bei einer Suche null — dort sagt 'groupCode', wohin eine Zeile gehört, und die Gliederung entsteht durch Blöcke statt durch Einrückung."

First observedSep 1, 2026

TDQS

A3.5/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true and openWorldHint=false, so the safety profile is covered. The description adds the no-argument hierarchy behavior, but its return-content details overlap with the existing output schema and it discloses nothing about access, limits, or failure modes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the returned content and then the no-argument behavior, with no filler. Efficient and well-ordered, though the returned-field enumeration borders on redundancy given the output schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only getter with an output schema and 100% parameter coverage, the description supplies enough to call it correctly, including the empty-argument case. It is only missing explicit sibling routing to seg4kde_search.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters (code, year) are already fully documented in the schema, including the 'leave empty' semantics the description repeats. Baseline 3 applies; the description adds no syntax or format detail beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description pairs a specific verb ('Liefert') with a concrete resource (the SEG-4-Kodierempfehlung full text) and enumerates the returned content. It does not explicitly contrast itself with the sibling seg4kde_search, so the get-vs-search distinction is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states what the tool returns when called without a number (the topmost outline level), which implies the usage context, but it never says when to prefer this over seg4kde_search or that a search is needed first to obtain a code. Usage is implied rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All DRGSystem — German medical coding catalogs tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?