medcode_browse_hierarchy
ActiveTool of io.github.cyanheads/medical-codes-mcp-server
Walk a US medical code system's hierarchy for discovery without a search term. With no `node`, returns the top-level entries (ICD-10-CM categories, HCPCS range buckets, or ICD-10-PCS first-axis values). With a `node`, returns its immediate children. ICD-10-CM and HCPCS use a prefix hierarchy (a shorter code is the parent of a longer one); ICD-10-PCS is axis-based — each of its 7 characters is an independent axis (section, body system, root operation, body part, approach, device, qualifier), but only the top-level Section axis is browsable (omit `node`): positions 2–7 are context-dependent on the preceding axis path and are not enumerable from a flat partial code. Lets an agent orient in an unfamiliar system or enumerate a category's specific codes.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"system"
],
"properties": {
"node": {
"type": "string",
"description": "A node to expand. For ICD-10-CM/HCPCS, a code whose children to list. ICD-10-PCS supports only top-level Section browsing (omit `node`) — a partial PCS code does not expand to next-position axis values. Omit for the top level."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max entries to return. Defaults to MEDCODE_MAX_RESULTS (50), ceiling 200."
},
"system": {
"enum": [
"ICD10CM",
"ICD10PCS",
"HCPCS",
"RXNORM"
],
"type": "string",
"description": "The code system to browse."
}
}
}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