medcode_search_codes
ActiveTool of io.github.cyanheads/medical-codes-mcp-server
Find US medical codes whose official descriptions match a described concept, via full-text search over the bundled index. Every search term must appear — matched first as a token prefix, then as a substring so inflected and compound forms are also found (a "neuropathy" search surfaces "mononeuropathy"/"polyneuropathy" siblings too, not only a standalone "neuropathy" token). 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, rank exact prefix matches ahead of substring-only matches with a deterministic tie-break, and disclose truncation with a `nextCursor`: pass it back as `cursor` to page through the full ranked set.
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 per page. 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\". Must not be blank or whitespace-only."
},
"cursor": {
"type": "string",
"description": "Opaque continuation token from a previous response's `nextCursor`, to fetch the next page of the same ranked result set. Omit for the first page."
},
"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