AutoICD MCP Server

AutoICD MCP Server

Give AI assistants the power of medical coding — ICD-10-CM and ICD-11 diagnosis coding, code search, crosswalk, and PHI de-identification via the AutoICD API.

An MCP (Model Context Protocol) server that connects AI assistants like Claude Desktop, Cursor, VS Code, and Windsurf to the AutoICD API for AI-powered ICD-10 and ICD-11 medical coding automation.

Why AutoICD API?

Get your API key at autoicdapi.com.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "autoicd": {
      "command": "npx",
      "args": ["-y", "autoicd-mcp"],
      "env": {
        "AUTOICD_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "autoicd": {
      "command": "npx",
      "args": ["-y", "autoicd-mcp"],
      "env": {
        "AUTOICD_API_KEY": "sk_your_api_key"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "autoicd": {
      "command": "npx",
      "args": ["-y", "autoicd-mcp"],
      "env": {
        "AUTOICD_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "autoicd": {
      "command": "npx",
      "args": ["-y", "autoicd-mcp"],
      "env": {
        "AUTOICD_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Available Tools

`code_diagnosis`

Extract medical diagnoses from clinical text and map them to ICD-10-CM codes.

Parameters:

• text (required) — Clinical text to process (progress notes, discharge summaries, etc.)
• top_k (optional, 1-25, default: 5) — Number of top ICD-10 candidates per entity
• include_negated (optional, default: true) — Include negated entities in results

Example prompts:

• "Code this note: Patient presents with acute lower back pain radiating to the left leg. Denies any numbness or tingling."
• "What ICD-10 codes apply to: 65-year-old male with type 2 diabetes, hypertension, and chronic kidney disease stage 3"
• "Code the following discharge summary: Patient admitted for COPD exacerbation with acute respiratory failure. History of CHF and atrial fibrillation."

The tool will extract medical entities, detect negations ("denies numbness"), and return ranked ICD-10 code candidates with confidence scores.

`search_codes`

Search the ICD-10-CM 2025 code set by description.

Parameters:

• query (required) — Search text to match against code descriptions
• limit (optional, 1-100, default: 20) — Maximum results
• offset (optional, default: 0) — Pagination offset

Example prompts:

• "Search for ICD-10 codes related to congestive heart failure"
• "Find all ICD-10 codes for diabetes"
• "What ICD-10 codes are there for anxiety disorders?"
• "Look up hypertension ICD-10 codes"

`get_code`

Get comprehensive details for a specific ICD-10-CM code.

Parameters:

• code (required) — ICD-10-CM code (e.g., "E11.9", "I10", "J44.1")

Example prompts:

• "Look up the details for ICD-10 code M54.5"
• "What does ICD-10 code I10 mean?"
• "Is E11.9 a billable code? What are its synonyms?"
• "Show me the SNOMED CT mappings for code J44.1"

Returns descriptions, billable status, SNOMED CT and UMLS synonyms, parent/child hierarchy, chapter classification, and ICD-11 crosswalk mappings.

`search_icd11_codes`

Search the ICD-11 code set by description.

Parameters:

• query (required) — Search text to match against ICD-11 code descriptions
• limit (optional, 1-100, default: 10) — Maximum results

Example prompts:

• "Search for ICD-11 codes related to diabetes"
• "Find ICD-11 codes for respiratory infections"
• "What are the ICD-11 codes for anxiety disorders?"

`get_icd11_code`

Get comprehensive details for a specific ICD-11 code, including ICD-10 crosswalk mappings.

Parameters:

• code (required) — ICD-11 code (e.g., "5A11", "BA00", "CA40.0")

**Example