io.github.stayce/icd-mcp

ICD MCP Server

Give any AI assistant instant access to the WHO ICD-10 and ICD-11 classification systems — the global standard behind every diagnosis code, hospital bill, and mortality statistic on earth.

12 actions. Both ICD versions. One tool call.

https://mcp-icd.medseal.app/mcp

What Can It Do?

Autocode clinical text into ICD-11 codes

Paste free-text clinical descriptions and get the right code back. No more manual lookups.

{"action": "autocode", "query": "acute bronchitis with fever"}
→ CA20 Acute bronchitis (92.3% confidence)

{"action": "autocode", "query": "patient presents with chest pain and shortness of breath"}
→ MD81 Chest pain (87.1% confidence)

Look up any ICD-10 or ICD-11 code instantly

Get definitions, coding notes, inclusions, exclusions — everything a coder needs.

{"action": "lookup", "code": "BA00"}
→ BA00: Lobar pneumonia — full definition, coding notes, inclusions/exclusions

{"action": "lookup", "code": "J18.9", "version": "10"}
→ J18.9: Pneumonia, unspecified (ICD-10)

Search by keyword

Don't know the code? Describe it and get ranked results.

{"action": "search", "query": "type 2 diabetes with kidney complications"}
→ Ranked ICD-11 results with codes and titles

{"action": "search", "query": "melanoma", "chapter": "02", "max_results": 5}
→ Filtered to neoplasm chapter

Browse the classification like a tree

Navigate interactively — see any code's parent, children, and where it sits in the hierarchy.

{"action": "browse"}
→ All 28 ICD-11 chapters (or 21 ICD-10 chapters)

{"action": "browse", "code": "BA00"}
→ Parent context + sub-categories with ▸ expansion markers

Trace a code's full lineage

Walk from any leaf code all the way up to its chapter root.

{"action": "ancestors", "code": "BA01.0"}
→ BA01.0 → BA01 → BA0Y-BA2Z → Diseases of the respiratory system → Chapter 12

Validate codes instantly

Quick yes/no — is this a real code? Is it a leaf or a category?

{"action": "validate", "code": "BA00"}
→ Valid ICD-11 code, category level, has sub-codes

{"action": "validate", "code": "XYZ99"}
→ Not a valid ICD-11 code

Built-in coding rules reference

No need to leave the conversation for coding guidelines.

{"action": "coding_rules", "topic": "extension_codes"}
→ Full guide to ICD-11 severity, temporality, anatomy, histopathology codes

{"action": "coding_rules", "topic": "clustering"}
→ How to combine codes with & and / operators

{"action": "coding_rules", "topic": "dagger_asterisk"}
→ ICD-10 etiology/manifestation dual coding system

Available topics: extension_codes, clustering, sequencing, dagger_asterisk, postcoordination

Get the big picture

High-level summaries of each classification system — chapter tables, key concepts, what's different.

{"action": "overview"}
→ ICD-11: 28 chapters, postcoordination, extension codes, what changed from ICD-10

{"action": "overview", "version": "10"}
→ ICD-10: 21 chapters, code ranges, dagger/asterisk system

All 12 Actions at a Glance

Who Is This For?

• Health IT developers building clinical apps, EHRs, or coding tools
• Medical coders who want AI-assisted code lookup and validation
• Health data analysts exploring classification structures
• Researchers working with WHO mortality/morbidity data
• AI/LLM builders adding medical coding capabilities to agents
• Anyone transitioning from ICD-10 to ICD-11 and needing both systems side by side

Quick Start

Use the hosted server (fastest)

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "icd": {
      "type": "url",
      "url": "https://mcp-icd.medseal.app/mcp"
    }
  }
}

Or connect from any MCP-compatible client using https://mcp-icd.medseal.app/mcp.

Deploy your own

1. Clone and install:

    git clone https://github.com/stayce/icd-mcp-cloudflare
    cd icd-mcp-cloudflare
    npm install

2. Get WHO API credentials (free):
   • Register at https://icd.who.int/icdapi
   • Get your Client ID and Secret
3. Set secrets and deploy:

    wrangler secret put WHO_CLIENT_ID
    wrangler secret put WHO_CLIENT_SECRET
    npm run deploy

That's it. Runs globally on Cloudflare's edge network.

Why This MCP?

Token efficient. One tool, 12 actions. No bloated tool lists eating context windows.

Both ICD versions. ICD-10 is still used for billing everywhere. ICD-11 is the future. You need both. Default is ICD-11; add "version": "10" for ICD-10.

Official WHO data. Direct from the WHO ICD-API — not a stale copy or a scraped dataset.

Autocode is the real deal. The WHO's own autocoding engine, not a keyword hack. Give it clinical text, get the right code.

Zero cold starts. Cloudflare Workers, not a container. Sub-50ms globally.

ICD-10 vs ICD-11

This server defaults to ICD-11 but fully supports both. Use "version": "10" for ICD-10 queries.

Part of the MedSeal MCP Suite

All deployed on Cloudflare Workers. All open source. All MCP-compatible.

License

MIT