AutoICD MCP Server

Give AI assistants the power of medical coding — ICD-10-CM, ICD-11, and ICF diagnosis and functioning coding, code search, crosswalk, Core Sets, 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, ICD-11, and ICF 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 prompts:

• "Look up ICD-11 code 5A11"

• "What is the ICD-10 equivalent of ICD-11 code BA00?"

• "Show me the details and crosswalk for ICD-11 code CA40.0"

Returns descriptions, Foundation URI, synonyms, parent/child hierarchy, chapter classification, and ICD-10 crosswalk mappings.

anonymize

De-identify Protected Health Information (PHI) in clinical text.

Parameters:

• text (required) — Clinical text containing PHI

Example prompts:

• "Remove all patient identifiers from this note: John Smith (DOB 03/15/1980) was seen at 123 Main St..."

• "De-identify this clinical text before I share it: Maria Garcia, MRN 789012, SSN 123-45-6789, diagnosed with pneumonia"

Detects and replaces names, dates, SSNs, phone numbers, emails, addresses, MRNs, and ages with type labels like [NAME], [DATE], [SSN].

icf_code

Code clinical text to WHO ICF functioning categories.

Parameters:

• text (required) — Clinical text describing functional status, disabilities, or impairments

• top_k (optional, 1-25, default: 5) — Number of top ICF candidates per entity

Example prompts:

• "Code this functional assessment to ICF: Patient has difficulty walking and limited grip strength after stroke"

• "What ICF codes apply to: Patient with reduced mobility, cognitive impairment, and difficulty with self-care"

icf_lookup

Look up details for a specific ICF code.

Parameters:

• code (required) — ICF code (e.g., "b730", "d450", "s110")

Example prompts:

• "Look up ICF code b730"

• "What does ICF code d450 mean?"

• "Show me the definition of ICF code s110"

Returns title, definition, component, chapter, parent/child hierarchy, inclusions, exclusions, and index terms.

icf_search

Search ICF codes by keyword.

Parameters:

• query (required) — Search text to match against ICF code descriptions

• limit (optional, 1-100, default: 20) — Maximum results

Example prompts:

• "Search for ICF codes related to mobility"

• "Find ICF codes for cognitive functions"

• "What ICF codes are there for self-care activities?"

icf_core_set

Get the ICF Core Set for an ICD-10 diagnosis — a curated list of ICF categories relevant to a specific condition.

Parameters:

• icd10_code (required) — ICD-10-CM code (e.g., "E11.9", "I63.9", "G35")

Example prompts:

• "What ICF Core Set applies to diabetes (E11.9)?"

• "Show me the ICF Core Set for stroke (I63.9)"

• "Get the brief and comprehensive ICF Core Sets for multiple sclerosis (G35)"

Returns condition name, brief Core Set (key categories), and comprehensive Core Set (full assessment categories).

Common ICD-10 Codes

Here are some of the most commonly coded conditions you can look up with this MCP server:

Browse the full ICD-10-CM Code Directory or find codes by condition.

Configuration

Use Cases

• EHR/EMR Integration — Automate diagnosis coding in electronic health record workflows

• Medical Billing — Accelerate revenue cycle management with AI-assisted code assignment

• Clinical Decision Support — Look up ICD-10 codes and hierarchies during clinical documentation

• Health-Tech Development — Build and test medical coding features with live API access in your IDE

• Research & Analytics — Search and explore the ICD-10-CM code set for epidemiological analysis

• Compliance — De-identify clinical text before processing or sharing

Requirements

• Node.js 18+

• An AutoICD API key — Get one free at autoicdapi.com

Links

• AutoICD API — autoicdapi.com

• API Documentation — autoicdapi.com/docs

• ICD-10-CM Code Directory — autoicdapi.com/icd10 — Browse all 74,000+ codes

• ICD-11 Code Directory — autoicdapi.com/icd11 — Browse the WHO ICD-11 MMS hierarchy

• ICD-10 ↔ ICD-11 Crosswalk — autoicdapi.com/icd10-to-icd11 — Map codes between revisions

• ICD-10 Codes by Condition — autoicdapi.com/icd10/condition — Find codes for common conditions

• TypeScript SDK — npmjs.com/package/autoicd

• Python SDK — pypi.org/project/autoicd

• SNOMED CT & UMLS Cross-References — autoicdapi.com/snomed-ct-umls

• ICD-10-CM Reference — CMS.gov

License

MIT