AutoICD MCP Server

Give AI assistants the power of medical coding — ICD-10-CM diagnosis coding, code search, 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 automated ICD-10 medical coding.

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 prompt: "Code this note: Patient presents with acute lower back pain radiating to the left leg. Denies any numbness or tingling."

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 prompt: "Search for ICD-10 codes related to congestive heart failure"

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 prompt: "Look up the details for ICD-10 code M54.5"

Returns descriptions, billable status, SNOMED CT and UMLS synonyms, parent/child hierarchy, and chapter classification.

anonymize

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

Parameters:

• text (required) — Clinical text containing PHI

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

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

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
• TypeScript SDK — npmjs.com/package/autoicd-js
• Python SDK — pypi.org/project/autoicd
• ICD-10-CM Reference — CMS.gov

License

MIT