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

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. 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"
      -  ]
      -}
  2. 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."
      +}
  3. Added

TDQS

A4.4/5.0
Behavior5/5

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

Beyond the readOnly/idempotent annotations, the description discloses the response structure (focus, parents, items), the behavior when code is omitted, and an important caveat that ICD-10 references are Orphanet's WHO mappings, not the German Alpha-ID-SE assignments. This is materially useful behavioral context for callers.

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 behavior is front-loaded and the warning is placed where it matters, but the English summary sentence largely duplicates the German explanation. The description is dense and useful, yet slightly longer than necessary.

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?

With a rich German description, a full input schema, an output schema, and read-only annotations, an agent has everything needed to call orpha_get correctly, including the null-code behavior and the cross-reference caveat. No critical usage gap remains.

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 the parameters are already well documented. The description adds little parameter-level detail beyond restating that omitting the code returns the top-level catalog, which duplicates the schema's description. No meaningful new semantics are added.

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 names the exact action and resource: retrieving all nomenclature data for one ORPHA code, including names, synonyms, status, and cross-references. It also explains the no-code behavior of returning specialty areas, which clearly distinguishes this getter from the sibling orpha_search.

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?

The description gives clear usage context: call with an ORPHA code for one rare-disease record, or without a code to browse the catalog by specialty. It does not explicitly name orpha_search as the alternative for query-style lookup, so it stops short of a full when-not instruction.

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