medcode_search_codes
ActiveTool of io.github.cyanheads/medical-codes-mcp-server
declared in 0.2.0
Find US medical codes whose official descriptions match a described concept, via full-text search over the bundled index. Every search term must appear (prefix-matched), so "diabetic neuropathy" returns codes mentioning both. Filter by `system` (ICD10CM/ICD10PCS/HCPCS/RXNORM), `billableOnly` to exclude headers/categories, and `chapter`. Use when you have a clinical description and need the code — the reverse of medcode_get_code. Results echo the resolved system per row for chaining, and disclose truncation when the result hits the cap.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max codes to return. Defaults to the server's MEDCODE_MAX_RESULTS (50), ceiling 200."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Clinical description to match, e.g. \"type 2 diabetes with neuropathy\"."
},
"system": {
"enum": [
"ICD10CM",
"ICD10PCS",
"HCPCS",
"RXNORM"
],
"type": "string",
"description": "Restrict results to one system. Omit to search all bundled systems."
},
"chapter": {
"type": "string",
"description": "Restrict to a chapter/range bucket (the value from a code's `chapter` field)."
},
"billableOnly": {
"type": "boolean",
"default": false,
"description": "When true, return only billable leaf codes (exclude headers/categories)."
}
}
}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