Medical code suggestions from clinical text
code_suggestSuggests ICD-10-CM, CPT, and HCPCS Level II codes from clinical or equipment descriptions, ranking matches by relevance and grouping matches for separate conditions or devices.
Instructions
Suggest ICD-10-CM, CPT and HCPCS Level II codes from a clinical or equipment description — a term search over the 90K-code CMS database, no language model. Works with natural sentences ("patient with obstructive sleep apnea prescribed CPAP" lists G47.33 and E0601 first), common abbreviations and alternate forms (CPAP, OSA, COPD, IG for immune globulin, type 2), and a typed side, sex or "without". Ranked by relevance (relevanceScore 0-1: how much of the description a code matches, and how closely), with two exceptions: the best code for each separate thing a description names (a diagnosis and a device) comes first, so the list is grouped rather than strictly sorted by relevanceScore; and a bare common condition ("hypertension") lists its ICD-10-CM default code first. Weak matches are left out rather than listed. Up to 500 characters, of which up to 10 distinct terms are searched, common words left out. Automatically refunds the call when nothing matches.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"description": "<description>"
},
"name": "code_suggest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max suggestions to return (default 10, max 50) | |
| codeType | No | Limit to specific code system | |
| description | Yes | Clinical description to find codes for (e.g., "chronic lower back pain") |