Quickstart: ICD-10 MCP Server

Get up and running with ICD-10 code lookup in Claude Desktop in under 5 minutes.

What is the FindICD10 MCP Server?

The FindICD10 MCP (Model Context Protocol) server gives Claude direct access to the complete ICD-10-CM code database. Instead of Claude guessing or providing outdated codes, it can:

• Search 90,000+ codes across 2025 and 2026 versions
• Get detailed code information including clinical notes, excludes, and billing status
• Find related codes (parent and sibling codes in the hierarchy)
• Convert between ICD-9 and ICD-10 using official CMS GEM mappings
• Analyze clinical notes to extract relevant diagnosis codes

Prerequisites

• Claude Desktop installed
• Node.js 18+ (for npx)
• Internet connection (the server calls findicd10.com API)

Installation

Step 1: Open Claude Desktop Settings

1. Open Claude Desktop
2. Click the Settings icon (gear) in the bottom left
3. Navigate to Developer > Edit Config

This opens your claude_desktop_config.json file.

Step 2: Add the MCP Server

Add the FindICD10 server to your mcpServers configuration:

{
  "mcpServers": {
    "findicd10": {
      "command": "npx",
      "args": ["-y", "@findicd10/mcp"]
    }
  }
}

If you already have other MCP servers configured, add findicd10 to the existing object:

{
  "mcpServers": {
    "other-server": { "..." },
    "findicd10": {
      "command": "npx",
      "args": ["-y", "@findicd10/mcp"]
    }
  }
}

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new MCP server.

Step 4: Verify Installation

Start a new conversation and ask Claude something like:

> "What is the ICD-10 code for type 2 diabetes with hyperglycemia?"

Claude should use the search_codes tool to find E11.65 and provide accurate, current information.

Available Tools

Once installed, Claude has access to 5 ICD-10 tools:

Example Conversations

Finding Codes

You: What are the ICD-10 codes for diabetic retinopathy?

Claude: Uses search_codes to find codes

The ICD-10-CM codes for diabetic retinopathy are organized by diabetes type and severity:

• E11.319 - Type 2 diabetes with unspecified diabetic retinopathy without macular edema
• E11.311 - Type 2 diabetes with unspecified diabetic retinopathy with macular edema
• E11.3211 - Type 2 diabetes with mild nonproliferative diabetic retinopathy with macular edema, right eye

Code Details

You: Tell me about code E11.65

Claude: Uses get_code to fetch details

E11.65 - Type 2 diabetes mellitus with hyperglycemia

• Billable: Yes
• Chapter: Endocrine, nutritional and metabolic diseases (E00-E89)

Clinical Notes:
- Use additional code to identify insulin use (Z79.4) or oral hypoglycemic use (Z79.84)

Excludes1 (cannot code together):
- Drug or chemical induced diabetes (E09.-)
- Gestational diabetes (O24.4-)
- Type 1 diabetes mellitus (E10.-)

ICD-9 to ICD-10 Conversion

You: What's the ICD-10 equivalent of ICD-9 code 250.00?

Claude: Uses convert_code

ICD-9 code 250.00 (Diabetes mellitus without complication, type II) maps to:

• E11.9 - Type 2 diabetes mellitus without complications

Note: This is an approximate mapping. Always verify against clinical documentation.

Clinical Note Analysis

You: Extract ICD-10 codes from this note: "Patient presents with uncontrolled type 2 diabetes, diabetic neuropathy in both feet, and stage 3 chronic kidney disease."

Claude: Uses analyze_note

Based on the clinical documentation, the following ICD-10 codes apply:

1. E11.65 - Type 2 diabetes mellitus with hyperglycemia (for "uncontrolled" diabetes)
2. E11.42 - Type 2 diabetes mellitus with diabetic polyneuropathy
3. E11.22 - Type 2 diabetes mellitus with diabetic chronic kidney disease
4. N18.3 - Chronic kidney disease, stage 3

Troubleshooting

Server not appearing in Claude

1. Ensure Node.js 18+ is installed: node --version
2. Check your config file syntax is valid JSON
3. Restart Claude Desktop completely (quit and reopen)

"Rate limit exceeded" errors

The API has rate limits to prevent abuse:
- 30 requests per minute for API/MCP calls
- Wait a moment and try again, or batch your queries

Incorrect or outdated codes

The MCP server uses the official CMS ICD-10-CM 2025 and 2026 code sets. If you believe a code is incorrect, please report the issue.

Next Steps

• Read the full MCP Server Documentation for all tool schemas
• Explore the REST API Reference for direct API access
• Browse codes on FindICD10.com

Support

Questions or issues? Contact us.