@findicd10/mcp

MCP (Model Context Protocol) server for ICD-10 medical code lookup. Use this server to give AI assistants access to ICD-10 diagnosis and procedure code search, code details, and clinical note analysis.

Installation

Claude Code (CLI)

Add the MCP server to your project:

claude mcp add findicd10 -- npx -y @findicd10/mcp

Or add manually to your Claude Code settings (.claude.json or project settings):

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

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Other MCP Clients

The server communicates via stdio. Run directly:

npx @findicd10/mcp

Or install globally:

npm install -g @findicd10/mcp
findicd10-mcp

Available Tools

search_codes

Search ICD-10 codes by keyword or phrase.

Parameters:

• query (required): Search query (e.g., "diabetes", "fracture arm")
• version (optional): ICD-10 version year - "2025" or "2026" (default: "2026")
• billable_only (optional): Only return billable codes (default: false)
• limit (optional): Maximum results 1-100 (default: 20)

Example:

Search for "type 2 diabetes with foot ulcer"

get_code

Get detailed information about a specific ICD-10 code.

Parameters:

• code (required): ICD-10 code (e.g., "E11.65", "A00")

Returns:

• Code description and billability status
• Clinical notes (includes, excludes1, excludes2)
• Code first/code also instructions
• 7th character definitions (if applicable)
• Child codes in the hierarchy

Example:

Get details for code E11.65

get_related_codes

Find codes related to a specific ICD-10 code (siblings in the hierarchy).

Parameters:

• code (required): ICD-10 code to find related codes for

Example:

Get related codes for E11.65

convert_code

Convert between ICD-9 and ICD-10 codes using GEM mappings.

Parameters:

• code (required): ICD-9 or ICD-10 code (auto-detects direction)
• version (optional): ICD-10 version for mapping (default: "2026")

Example:

Convert ICD-9 code 250.00 to ICD-10

analyze_note

Analyze clinical note text to extract potential ICD-10 codes using AI.

Parameters:

• note (required): Clinical note text to analyze

Returns:

• Suggested ICD-10 codes
• Description and billability status
• Rationale for each suggestion

Example:

Analyze: "Patient presents with uncontrolled type 2 diabetes mellitus with diabetic chronic kidney disease stage 3"

Rate Limits

The FindICD10 API has rate limits:

• Web browsers: 120 requests/minute
• API/CLI tools: 30 requests/minute

Support

• Documentation: https://findicd10.com/developers
• Issues: https://github.com/findicd10/icd-10/issues

License

MIT