Skip to main content
Glama

DRGSystem — German medical coding catalogs

by de.drgsystem
OverviewDiscussionsAdmin

ICD-10-GM Alphabet durchsuchen

icd10alpha_search
Read-onlyIdempotent

Durchsucht das Alphabetische Verzeichnis der ICD-10-GM. Das Alphabet führt die klinischen und umgangssprachlichen Bezeichnungen einer Diagnose und weist ihnen die Schlüsselnummern zu — der übliche Einstieg, wenn nur der Diagnosetext bekannt ist. Jeder Treffer nennt Primär-, Stern- und Zusatzschlüsselnummer bereits mit ihrem amtlichen Titel aus dem systematischen Verzeichnis. [EN] Best first tool for natural-language diagnosis search: use it when the user asks to find diagnoses by text, symptom, disease name, colloquial German wording or a partial term such as 'Herz', 'Diabetes' or 'Schmerz'. Searches the ICD-10-GM Alphabetical Index and maps clinical and everyday diagnosis terms to ICD-10-GM codes. Use icd10_search instead when an ICD code is already known, and icd10_get for the full entry of one code.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
yearNoKatalogjahr (z. B. 2026). Leer lassen für das aktuellste verfügbare Jahr.
limitNoMaximale Anzahl Treffer, 1 bis 100. Standard 25.
queryYesSuchbegriff aus dem Alphabet (z. B. 'Zuckerkrankheit', 'Herzinfarkt') oder eine Schlüsselnummer. [EN] Diagnosis wording in German; translate the user's term first ('heart' → 'Herz').
offsetNoAnzahl zu überspringender Treffer für das Blättern. Standard 0.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
yearNoKatalogjahr, aus dem die Einträge stammen.
offsetNoAnzahl der übersprungenen Treffer vor dieser Seite.
entriesNoDie Einträge dieser Seite, absteigend nach Trefferqualität sortiert.
totalCountNoGesamtzahl der Treffer, unabhängig von der zurückgegebenen Seite.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • removedOutput schema / properties / entries / items / properties / code
      Removed value: -{
-  "description": "Fortlaufende Satznummer des BfArM innerhalb des Alphabetischen Verzeichnisses. Kein ICD-Kode.",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • removedOutput schema / properties / entries / items / properties / printFlag
      Removed value: -{
-  "description": "Druckkennzeichen des BfArM: true, wenn der Eintrag in der gedruckten Fassung erscheint.",
-  "type": "boolean"
-}
    • removedOutput schema / properties / entries / items / properties / textHighlight
      Removed value: -{
-  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'text' — 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 außerhalb einer Textsuche. Über MCP immer null.",
-  "items": {
-    "type": "number"
-  },
-  "type": [
-    "array",
-    "null"
-  ]
-}
  2. Changed3 schema fields changed
    • addedOutput schema / properties / entries / items / properties / alphaId
      Added value: +{
+  "description": "Stabile Alpha-Identifikationsnummer der Datei Alpha-ID-SE (z. B. 'I19094') — ein nicht klassifizierender Diagnosenkode für die elektronische Weiterverarbeitung. Null, wenn der Jahrgang keine Alpha-ID-SE führt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / entries / items / properties / isRetired
      Added value: +{
+  "description": "True, wenn der Eintrag aus dem Alphabetischen Verzeichnis gestrichen wurde und nur noch geführt wird, damit alte Alpha-IDs auflösbar bleiben. Er darf nicht mehr zur Kodierung gewählt werden.",
+  "type": "boolean"
+}
    • addedOutput schema / properties / entries / items / properties / orphaCode
      Added value: +{
+  "description": "Orpha-Kennnummer der Seltenen Erkrankung. Wo sie steht, ist die Kodierung damit im stationären Bereich seit dem 1.4.2023 verpflichtend (Bekanntmachung des BMG vom 17.11.2022, BAnz AT 07.12.2022 B1).",
+  "type": [
+    "string",
+    "null"
+  ]
+}
  3. Changed1 schema field changed
    • addedOutput schema / properties / entries / items / properties / textHighlight
      Added value: +{
+  "description": "Nur für die Trefferhervorhebung im Web-Katalog: Gewicht je Zeichen von 'text' — 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 außerhalb einer Textsuche. Über MCP immer null.",
+  "items": {
+    "type": "number"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}
  4. First observed

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already cover read-only and idempotent behavior. The description adds that results include primary, asterisk, and additional keys with official titles from the systematic index, which is valuable context beyond the annotations. No contradictions.

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 bilingual, with German and English sections. It is front-loaded with the main purpose and includes practical examples. Though slightly repetitive across languages, it is well-structured and each part adds value.

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?

Given the output schema exists to describe return values, the description covers purpose, usage, alternatives, and parameter nuances. Nothing critical is missing for an agent to correctly select and invoke this tool.

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

Parameters4/5

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

Schema coverage is 100%, so parameters are documented. The description adds semantic guidance that query should be in German and provides examples like 'Herz' and 'Diabetes', plus advice to translate user terms first. This goes beyond the schema's basic descriptions.

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 clearly states the tool searches the ICD-10-GM Alphabetical Index, mapping clinical and colloquial diagnosis terms to codes. It names the specific resource and differentiates from siblings icd10_search and icd10_get, making it unambiguous which tool to use for text-based searches.

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

Usage Guidelines5/5

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

Explicitly states when to use this tool (natural-language diagnosis search, partial terms) and when to use alternatives (icd10_search for known codes, icd10_get for full entries). This provides clear routing guidance with no ambiguity.

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