Skip to main content
Glama

DRGSystem — German medical coding catalogs

by de.drgsystem
OverviewDiscussionsAdmin

Seltene Erkrankung abrufen

orpha_get
Read-onlyIdempotent

Liefert in 'focus' alles, was die Nomenklatur zu einer Orpha-Kennnummer führt: Bezeichnung, Synonyme, Art des Eintrags, Stand bei Orphanet, die Adresse im Orphanet-Portal sowie die Verweise auf ICD-10 der WHO, ICD-11 und OMIM. Dazu in 'parents' das Fachgebiet und in 'items' die darunter geführten Einträge. Ohne Kennnummer aufgerufen liefert die Funktion die Fachgebiete, sodass sich der Katalog durchblättern lässt. Achtung: die ICD-10-Verweise sind die von Orphanet auf die ICD-10 der WHO — für die Kodierung in Deutschland gilt die amtliche Zuordnung der Datei Alpha-ID-SE. [EN] Everything about one ORPHA code: names, synonyms, status, and its links into ICD-10, ICD-11 and OMIM.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
codeNoOrpha-Kennnummer ohne Präfix (z. B. '558'). Leer lassen für die oberste Ebene des Katalogs.
yearNoJahrgang der Nomenklatur. Leer lassen für den aktuellsten verfügbaren.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
yearNoKatalogjahr, aus dem alle Daten dieser Antwort stammen.
focusNoDer abgefragte Kode mit allen Detaildaten. Null bei einer Suche und beim Katalog-Einstieg (leerer Kode).
itemsNoDie Kodeliste der Antwort: bei einer Abfrage die direkt untergeordneten Kodes von 'focus' (bzw. die oberste Ebene bei leerem Kode), bei einer Suche die Treffer.
parentsNoÜbergeordnete Kodes von 'focus' als Pfad von der obersten Ebene abwärts (Brotkrumen). Leer bei einer Suche und beim Katalog-Einstieg.
interpretationNoNur bei einer Suche: wie die Suche die Anfrage gelesen hat. Null außerhalb der Suche.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed18 schema fields changed
    • addedOutput schema / properties / focus / properties / icdCodes / properties / value / items / properties
      Added value: +{
+  "code": {
+    "description": "Normalisierter Schlüssel ohne Trennzeichen, wie er für Abfragen und URLs verwendet wird (z. B. 'A010' für den ICD-Kode A01.0). Dieser Wert ist als 'code' an alle Katalog-Funktionen zurückzugeben.",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "description": {
+    "description": "Amtlicher Titel des Kodes (Diagnose-, Prozedur- bzw. Entgeltbezeichnung).",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "fullCode": {
+    "description": "Der Kode in der amtlichen Schreibweise, wie er dem Anwender angezeigt und in Dokumenten kodiert wird (z. B. 'A01.0', '5-470.0').",
+    "type": [
+      "string",
+      "null"
+    ]
+  }
+}
    • changedOutput schema / properties / focus / properties / icdCodes / properties / value / items / type
      Previous value: -"string"New value: +"object"
    • removedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / dkrReferences
      Removed value: -{
-  "description": "Deutsche Kodierrichtlinien (DKR), die diesen Kode ausdrücklich nennen.",
-  "properties": {
-    "sourceYear": {
-      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
-      "type": "integer"
-    },
-    "value": {
-      "description": "Der eigentliche Wert.",
-      "items": {
-        "properties": {
-          "code": {
-            "description": "Normalisierter Schlüssel ohne Trennzeichen, wie er für Abfragen und URLs verwendet wird (z. B. 'A010' für den ICD-Kode A01.0). Dieser Wert ist als 'code' an alle Katalog-Funktionen zurückzugeben.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "description": {
-            "description": "Amtlicher Titel des Kodes (Diagnose-, Prozedur- bzw. Entgeltbezeichnung).",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "fullCode": {
-            "description": "Der Kode in der amtlichen Schreibweise, wie er dem Anwender angezeigt und in Dokumenten kodiert wird (z. B. 'A01.0', '5-470.0').",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "type": "array"
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}
    • removedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / isChronic
      Removed value: -{
-  "description": "Gesetzt, wenn der Kode in der Liste der chronischen Krankheiten (Chroniker-Regelung) geführt wird; null, wenn nicht.",
-  "properties": {
-    "sourceYear": {
-      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
-      "type": "integer"
-    },
-    "value": {
-      "description": "Der eigentliche Wert.",
-      "type": "boolean"
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / ruleCount
      Added value: +{
+  "description": "Anzahl der Regeln außerhalb des Katalogs, die für diesen Kode im Katalogjahr gelten: Kodierrichtlinien, Schlichtungsentscheidungen, SEG-4-Kodierempfehlungen (ohne Beispiele, einschließlich der vom übergeordneten Kode geerbten). Null, wenn es keine gibt. Die Regeln selbst liefert 'rules_for_code'.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
    • removedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / seg4KdeReferences
      Removed value: -{
-  "description": "Kodierempfehlungen der SEG-4 der MDK-Gemeinschaft, die diesen Kode nennen.",
-  "properties": {
-    "sourceYear": {
-      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
-      "type": "integer"
-    },
-    "value": {
-      "description": "Der eigentliche Wert.",
-      "items": {
-        "properties": {
-          "code": {
-            "description": "Nummer der SEG-4-Kodierempfehlung.",
-            "type": "string"
-          },
-          "description": {
-            "description": "Titel der Kodierempfehlung.",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "type": "array"
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / versorgungspauschale
      Added value: +{
+  "description": "Gesetzt, wenn die Diagnose die hausärztliche Versorgungspauschale (GOP 03100 EBM) begründen kann; null, wenn nicht oder vor deren Inkrafttreten.",
+  "properties": {
+    "gop": {
+      "description": "Gebührenordnungsposition im EBM, «03100».",
+      "type": "string"
+    },
+    "listedAs": {
+      "description": "Wie der Beschluss die Diagnose nennt, z. B. «I10.0- (ausgenommen I10.01)».",
+      "type": "string"
+    },
+    "validFrom": {
+      "description": "Ab wann die Pauschale berechnungsfähig ist.",
+      "format": "date",
+      "type": "string"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
    • changedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes / description
      Previous value: -"Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), als Kodes in amtlicher Schreibweise. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage."New value: +"Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), mit Kode und Bezeichnung. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage."
    • removedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes / properties / value / $ref
      Removed value: -"#/properties/focus/properties/icdCodes/properties/value"
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes / properties / value / items / properties
      Added value: +{
+  "code": {
+    "description": "Normalisierter Schlüssel ohne Trennzeichen, wie er für Abfragen und URLs verwendet wird (z. B. 'A010' für den ICD-Kode A01.0). Dieser Wert ist als 'code' an alle Katalog-Funktionen zurückzugeben.",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "description": {
+    "description": "Amtlicher Titel des Kodes (Diagnose-, Prozedur- bzw. Entgeltbezeichnung).",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "fullCode": {
+    "description": "Der Kode in der amtlichen Schreibweise, wie er dem Anwender angezeigt und in Dokumenten kodiert wird (z. B. 'A01.0', '5-470.0').",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "price": {
+    "description": "Bundeseinheitlicher Betrag des Zusatzentgelts in Euro. Null bei unbewerteten Zusatzentgelten oder wenn der Katalog einen Verweis abdruckt.",
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  "priceNote": {
+    "description": "Wortlaut der Betragsspalte, wenn dort statt einer Zahl ein Verweis steht (z. B. 'siehe Anlage 5').",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "source": {
+    "description": "Herkunft des Zusatzentgelts: 'Bewertet' = mit bundeseinheitlichem Betrag, 'Unbewertet' = krankenhausindividuell zu vereinbaren.",
+    "enum": [
+      "Undefined",
+      "Bewertet",
+      "Unbewertet"
+    ],
+    "type": "string"
+  }
+}
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes / properties / value / items / type
      Added value: +"object"
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes / properties / value / type
      Added value: +"array"
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / dkrReferences
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/dkrReferences",
-  "description": "Deutsche Kodierrichtlinien (DKR), die diesen Kode ausdrücklich nennen."
-}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / isChronic
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/isChronic",
-  "description": "Gesetzt, wenn der Kode in der Liste der chronischen Krankheiten (Chroniker-Regelung) geführt wird; null, wenn nicht."
-}
    • addedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / ruleCount
      Added value: +{
+  "description": "Anzahl der Regeln außerhalb des Katalogs, die für diesen Kode im Katalogjahr gelten: Kodierrichtlinien, Schlichtungsentscheidungen, SEG-4-Kodierempfehlungen (ohne Beispiele, einschließlich der vom übergeordneten Kode geerbten). Null, wenn es keine gibt. Die Regeln selbst liefert 'rules_for_code'.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / seg4KdeReferences
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/seg4KdeReferences",
-  "description": "Kodierempfehlungen der SEG-4 der MDK-Gemeinschaft, die diesen Kode nennen."
-}
    • addedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / versorgungspauschale
      Added value: +{
+  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/versorgungspauschale",
+  "description": "Gesetzt, wenn die Diagnose die hausärztliche Versorgungspauschale (GOP 03100 EBM) begründen kann; null, wenn nicht oder vor deren Inkrafttreten."
+}
    • changedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / zusatzentgeltCodes / description
      Previous value: -"Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), als Kodes in amtlicher Schreibweise. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage."New value: +"Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), mit Kode und Bezeichnung. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage."
  2. Changed12 schema fields changed
    • 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 / icdDetails / properties / value / items / properties / icd / properties / atcCodes
      Removed value: -{
-  "description": "ATC-Kodes der Arzneimittel, die dieser Diagnose zugeordnet sind — nur die Schlüssel. Die vollständigen Datensätze liefert die Detailabfrage des Kodes.",
-  "properties": {
-    "sourceYear": {
-      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
-      "type": "integer"
-    },
-    "value": {
-      "$ref": "#/properties/focus/properties/icdCodes/properties/value",
-      "description": "Der eigentliche Wert.",
-      "items": {}
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}
    • removedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / 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 / icdDetails / properties / value / items / properties / icd / 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 / focus / properties / icdDetails / properties / value / items / properties / icd / properties / morbiRsa
      Removed value: -{
-  "description": "Zuordnung im Morbi-RSA (Morbiditätsorientierter Risikostrukturausgleich): DxG- und HmG-Gruppe. Null, wenn der Kode dort nicht geführt wird.",
-  "properties": {
-    "sourceYear": {
-      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
-      "type": "integer"
-    },
-    "value": {
-      "description": "Der eigentliche Wert.",
-      "properties": {
-        "dxgCode": {
-          "description": "Nummer der Diagnosegruppe (DxG) im Morbi-RSA, der die Diagnose zugeordnet ist.",
-          "type": "integer"
-        },
-        "dxgDescription": {
-          "description": "Bezeichnung der Diagnosegruppe (DxG).",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "hmgCode": {
-          "description": "Nummer der hierarchisierten Morbiditätsgruppe (HmG), in die die Diagnosegruppe einfließt.",
-          "type": "integer"
-        },
-        "hmgDescription": {
-          "description": "Bezeichnung der hierarchisierten Morbiditätsgruppe (HmG).",
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / atcCodes
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/atcCodes",
-  "description": "ATC-Kodes der Arzneimittel, die dieser Diagnose zugeordnet sind — nur die Schlüssel. Die vollständigen Datensätze liefert die Detailabfrage des Kodes."
-}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / descriptionHighlight
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/descriptionHighlight",
-  "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": {}
-}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / matchedTermHighlight
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/matchedTermHighlight",
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'matchedTerm', gleiche Skala wie 'descriptionHighlight'. Über MCP immer null.",
-  "items": {}
-}
    • removedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / morbiRsa
      Removed value: -{
-  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/morbiRsa",
-  "description": "Zuordnung im Morbi-RSA (Morbiditätsorientierter Risikostrukturausgleich): DxG- und HmG-Gruppe. Null, wenn der Kode dort nicht geführt wird."
-}
    • 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"
-  ]
-}
  3. Changed2 schema fields changed
    • addedOutput schema / properties / focus / properties / icdDetails / properties / value / items / properties / icd / properties / zusatzentgeltCodes
      Added value: +{
+  "description": "Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), als Kodes in amtlicher Schreibweise. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage.",
+  "properties": {
+    "sourceYear": {
+      "description": "Jahrgang des Katalogs, aus dem der Wert stammt. Weicht er vom abgefragten Jahr ab, liegen für das abgefragte Jahr noch keine Daten vor und es wird der letzte verfügbare Jahrgang gezeigt.",
+      "type": "integer"
+    },
+    "value": {
+      "$ref": "#/properties/focus/properties/icdCodes/properties/value",
+      "description": "Der eigentliche Wert.",
+      "items": {}
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
    • addedOutput schema / properties / focus / properties / icdMappings / items / properties / icd / properties / zusatzentgeltCodes
      Added value: +{
+  "$ref": "#/properties/focus/properties/icdDetails/properties/value/items/properties/icd/properties/zusatzentgeltCodes",
+  "description": "Zusatzentgelte, denen diese Diagnose in Anlage 7 des Fallpauschalenkatalogs zugeordnet ist (Blutgerinnungsstörungen), als Kodes in amtlicher Schreibweise. Betrag, auslösende OPS-Kodes und Fußnoten liefert die Detailabfrage."
+}
  4. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/closed-world, so safety is covered. Beyond that the description discloses non-obvious behavior: the no-code case returns the catalog's top level, the response is split into 'focus', 'parents' and 'items', and the ICD-10 references are Orphanet's mapping rather than the official German coding. That warning is genuinely useful supplemental context.

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?

The core content is front-loaded (what 'focus'/'parents'/'items' contain), then the no-code case, then the important caveat. Every German sentence carries information; the trailing English [EN] summary largely repeats what precedes it and is slightly redundant.

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

Completeness5/5

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

Although an output schema exists, the description still sketches the return structure, covers the edge case of omitting the code, and flags the ICD-10/Alpha-ID-SE pitfall. Combined with annotations covering safety, nothing an agent needs to call this correctly is missing.

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 coverage is 100%, with both 'code' and 'year' fully documented in the schema, so the schema does the heavy lifting (baseline 3). The description elaborates the behavior of omitting 'code' (returns Fachgebiete) beyond the schema's terse 'Leer lassen für die oberste Ebene', but says nothing about 'year'.

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 states a precise verb and resource ('Liefert alles, was die Nomenklatur zu einer Orpha-Kennnummer führt') and enumerates the payload (Bezeichnung, Synonyme, Art des Eintrags, ICD-10/ICD-11/OMIM links). An agent can tell exactly what this tool returns. It does not name the sibling orpha_search to differentiate by name, so it stays at 4.

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

Usage Guidelines4/5

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

It clearly establishes context: call with a code for one entry, call without a code to browse the top level (Fachgebiete). It adds a domain-specific caveat about ICD-10 mappings vs the German Alpha-ID-SE. It stops short of naming orpha_search as the way to discover codes, so it is not a full 5.

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 toolsInspect
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