medcode_get_code
ActiveTool of io.github.cyanheads/medical-codes-mcp-server
Decode one or more US medical codes to their official descriptions across ICD-10-CM (diagnoses), ICD-10-PCS (inpatient procedures), HCPCS Level II (supplies/drugs/services), and RxNorm (drugs, by RXCUI). Also decodes a National Drug Code (NDC) — hyphenated or 10/11-digit — directly to its RxNorm product offline, tagged `source: "NDC"`. Auto-detects the system from each code's shape; pass an explicit `system` only when a value is genuinely ambiguous. Accepts 1–50 codes and returns partial success: resolved codes in `found`, unresolved in `notFound` with a per-code reason, so one bad code never fails the batch. Set `includeHierarchy` to attach each code's parent and immediate children. The resolved `system` is echoed on every result for chaining into medcode_map_codes or a billability check.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"codes"
],
"properties": {
"codes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "A single code to decode (with or without dots), an RXCUI, or an NDC."
},
"maxItems": 50,
"minItems": 1,
"description": "Codes to decode (1–50). Mixed systems are fine — each is detected independently. An NDC (hyphenated or 10/11-digit) decodes to its RxNorm product."
},
"system": {
"enum": [
"ICD10CM",
"ICD10PCS",
"HCPCS",
"RXNORM"
],
"type": "string",
"description": "Force every code to be looked up in this system. Omit to auto-detect per code."
},
"includeHierarchy": {
"type": "boolean",
"default": false,
"description": "When true, attach each found code's parent and immediate children."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
io.github.cyanheads/medical-codes-mcp-server
https://github.com/cyanheads/medical-codes-mcp-server
2/7 registries