Skip to main content
Glama

DRGSystem — German medical coding catalogs

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

NameRequiredDescriptionDefault
codeNoOrpha-Kennnummer ohne Präfix (z. B. '558'). Leer lassen für die oberste Ebene des Katalogs.
yearNoKatalogjahr — nur angeben, wenn ausdrücklich eine bestimmte Fassung gebraucht wird. Leer lassen (empfohlen): dann kommt die jüngste Fassung, in der es den Kode gibt, auch für inzwischen entfallene Kodes; welcher Jahrgang das ist, steht in 'year' der Antwort.

Output Schema

NameRequiredDescriptionDefault
infoNoWas über den Jahrgang zu wissen ist, etwa «Version 2026» (ICD-10-GM 2027) oder «Vorabfassung». Null ohne.
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. Changed1 schema field changed
    • changedInput schema / properties / year / description
      Previous value: -"Jahrgang der Nomenklatur. Leer lassen für den aktuellsten verfügbaren."New value: +"Katalogjahr — nur angeben, wenn ausdrücklich eine bestimmte Fassung gebraucht wird. Leer lassen (empfohlen): dann kommt die jüngste Fassung, in der es den Kode gibt, auch für inzwischen entfallene Kodes; welcher Jahrgang das ist, steht in 'year' der Antwort."
  2. Changed1 schema field changed
    • addedOutput schema / properties / info
      Added value: +{
      +  "description": "Was über den Jahrgang zu wissen ist, etwa «Version 2026» (ICD-10-GM 2027) oder «Vorabfassung». Null ohne.",
      +  "properties": {
      +    "subname": {
      +      "description": "Zusatz zum Namen des Jahrgangs, etwa «Version 2026» oder «Vorabfassung». Null ohne Zusatz.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "subnameComment": {
      +      "description": "Erläuterung zum Zusatz in einem Satz oder zwei. Null ohne Erläuterung.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  3. 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."
  4. 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"
      -  ]
      -}
  5. 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."
      +}
  6. Added

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare read-only, idempotent, and closed-world behavior. The description adds meaningful context beyond that: the response grouping into 'focus', 'parents', and 'items', the browse behavior when no code is supplied, and an important caveat that Orphanet's ICD-10 links are WHO ICD-10 rather than Germany's Alpha-ID-SE mapping.

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 description is front-loaded with the core retrieval behavior and then covers browsing and the ICD-10 caveat. It is somewhat long and includes a bilingual English restatement that duplicates the German summary, but the content is largely purposeful.

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?

The tool is simple, both parameters are fully documented in the schema, annotations cover safety and idempotency, and an output schema exists. The description still supplies useful behavioral and caveat context, making the definition complete for correct invocation.

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%, so both parameters are fully documented in the input schema. The description reinforces the meaning of an empty code by describing catalog browsing, but it never mentions the 'year' parameter or its fallback-to-latest-edition behavior, so it adds little beyond the schema.

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

Purpose5/5

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

The description states a specific verb and resource: it retrieves everything the nomenclature has for one ORPHA code, including names, synonyms, status, portal links, and ICD/OMIM references. It also explains the no-code behavior as browsing the catalog's top level, which distinguishes it from the sibling orpha_search tool.

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 gives a clear usage condition: with a code it returns detailed entry data, and without a code it returns the subject areas for browsing the catalog. It does not explicitly route users to orpha_search when they need to find a code first, so it stops short of full alternative guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources