Icd Mcp Cloudflare MCP Server

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