{
  "markdown": "# ICD MCP Server\n\nGive 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.\n\n**12 actions. Both ICD versions. One tool call.**\n\n[![CI](https://github.com/stayce/icd-mcp-cloudflare/actions/workflows/ci.yml/badge.svg)](https://github.com/stayce/icd-mcp-cloudflare/actions/workflows/ci.yml)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)\n[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-orange)](https://workers.cloudflare.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n```\nhttps://mcp-icd.medseal.app/mcp\n```\n\n---\n\n## What Can It Do?\n\n### Autocode clinical text into ICD-11 codes\n\nPaste free-text clinical descriptions and get the right code back. No more manual lookups.\n\n```json\n{\"action\": \"autocode\", \"query\": \"acute bronchitis with fever\"}\n→ CA20 Acute bronchitis (92.3% confidence)\n\n{\"action\": \"autocode\", \"query\": \"patient presents with chest pain and shortness of breath\"}\n→ MD81 Chest pain (87.1% confidence)\n```\n\n### Look up any ICD-10 or ICD-11 code instantly\n\nGet definitions, coding notes, inclusions, exclusions — everything a coder needs.\n\n```json\n{\"action\": \"lookup\", \"code\": \"BA00\"}\n→ BA00: Lobar pneumonia — full definition, coding notes, inclusions/exclusions\n\n{\"action\": \"lookup\", \"code\": \"J18.9\", \"version\": \"10\"}\n→ J18.9: Pneumonia, unspecified (ICD-10)\n```\n\n### Search by keyword\n\nDon't know the code? Describe it and get ranked results.\n\n```json\n{\"action\": \"search\", \"query\": \"type 2 diabetes with kidney complications\"}\n→ Ranked ICD-11 results with codes and titles\n\n{\"action\": \"search\", \"query\": \"melanoma\", \"chapter\": \"02\", \"max_results\": 5}\n→ Filtered to neoplasm chapter\n```\n\n### Browse the classification like a tree\n\nNavigate interactively — see any code's parent, children, and where it sits in the hierarchy.\n\n```json\n{\"action\": \"browse\"}\n→ All 28 ICD-11 chapters (or 21 ICD-10 chapters)\n\n{\"action\": \"browse\", \"code\": \"BA00\"}\n→ Parent context + sub-categories with ▸ expansion markers\n```\n\n### Trace a code's full lineage\n\nWalk from any leaf code all the way up to its chapter root.\n\n```json\n{\"action\": \"ancestors\", \"code\": \"BA01.0\"}\n→ BA01.0 → BA01 → BA0Y-BA2Z → Diseases of the respiratory system → Chapter 12\n```\n\n### Validate codes instantly\n\nQuick yes/no — is this a real code? Is it a leaf or a category?\n\n```json\n{\"action\": \"validate\", \"code\": \"BA00\"}\n→ Valid ICD-11 code, category level, has sub-codes\n\n{\"action\": \"validate\", \"code\": \"XYZ99\"}\n→ Not a valid ICD-11 code\n```\n\n### Built-in coding rules reference\n\nNo need to leave the conversation for coding guidelines.\n\n```json\n{\"action\": \"coding_rules\", \"topic\": \"extension_codes\"}\n→ Full guide to ICD-11 severity, temporality, anatomy, histopathology codes\n\n{\"action\": \"coding_rules\", \"topic\": \"clustering\"}\n→ How to combine codes with & and / operators\n\n{\"action\": \"coding_rules\", \"topic\": \"dagger_asterisk\"}\n→ ICD-10 etiology/manifestation dual coding system\n```\n\nAvailable topics: `extension_codes`, `clustering`, `sequencing`, `dagger_asterisk`, `postcoordination`\n\n### Get the big picture\n\nHigh-level summaries of each classification system — chapter tables, key concepts, what's different.\n\n```json\n{\"action\": \"overview\"}\n→ ICD-11: 28 chapters, postcoordination, extension codes, what changed from ICD-10\n\n{\"action\": \"overview\", \"version\": \"10\"}\n→ ICD-10: 21 chapters, code ranges, dagger/asterisk system\n```\n\n---\n\n## All 12 Actions at a Glance\n\n| Action | What it does | ICD-10 | ICD-11 |\n|--------|-------------|--------|--------|\n| `lookup` | Full code details with definitions | Yes | Yes |\n| `search` | Find codes by keyword | - | Yes |\n| `autocode` | Clinical text → best matching code | - | Yes |\n| `browse` | Navigate the hierarchy interactively | Yes | Yes |\n| `chapters` | List all classification chapters | Yes | Yes |\n| `children` | Get sub-codes under any code | Yes | Yes |\n| `ancestors` | Trace lineage up to chapter root | Yes | Yes |\n| `validate` | Check if a code exists and its level | Yes | Yes |\n| `coding_rules` | Coding conventions reference | Yes | Yes |\n| `overview` | Classification system summary | Yes | Yes |\n| `api` | Raw WHO API access | Yes | Yes |\n| `help` | Action reference and examples | - | - |\n\n---\n\n## Who Is This For?\n\n- **Health IT developers** building clinical apps, EHRs, or coding tools\n- **Medical coders** who want AI-assisted code lookup and validation\n- **Health data analysts** exploring classification structures\n- **Researchers** working with WHO mortality/morbidity data\n- **AI/LLM builders** adding medical coding capabilities to agents\n- **Anyone transitioning from ICD-10 to ICD-11** and needing both systems side by side\n\n---\n\n## Quick Start\n\n### Use the hosted server (fastest)\n\nAdd to your Claude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"icd\": {\n      \"type\": \"url\",\n      \"url\": \"https://mcp-icd.medseal.app/mcp\"\n    }\n  }\n}\n```\n\nOr connect from any MCP-compatible client using `https://mcp-icd.medseal.app/mcp`.\n\n### Deploy your own\n\n1. **Clone and install:**\n   ```bash\n   git clone https://github.com/stayce/icd-mcp-cloudflare\n   cd icd-mcp-cloudflare\n   npm install\n   ```\n\n2. **Get WHO API credentials** (free):\n   - Register at https://icd.who.int/icdapi\n   - Get your Client ID and Secret\n\n3. **Set secrets and deploy:**\n   ```bash\n   wrangler secret put WHO_CLIENT_ID\n   wrangler secret put WHO_CLIENT_SECRET\n   npm run deploy\n   ```\n\nThat's it. Runs globally on Cloudflare's edge network.\n\n---\n\n## Why This MCP?\n\n**Token efficient.** One tool, 12 actions. No bloated tool lists eating context windows.\n\n**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.\n\n**Official WHO data.** Direct from the WHO ICD-API — not a stale copy or a scraped dataset.\n\n**Autocode is the real deal.** The WHO's own autocoding engine, not a keyword hack. Give it clinical text, get the right code.\n\n**Zero cold starts.** Cloudflare Workers, not a container. Sub-50ms globally.\n\n---\n\n## ICD-10 vs ICD-11\n\n| | ICD-10 | ICD-11 |\n|---|--------|--------|\n| **Adopted** | 1990 | 2019 |\n| **Codes** | ~14,400 | ~17,000 |\n| **Format** | A00.0–Z99.9 | BA00, 1A00.1 |\n| **Search** | Not supported by WHO API | Full-text + flexisearch |\n| **Autocoding** | Not available | Yes |\n| **Key feature** | Dagger/asterisk dual coding | Postcoordination + extension codes |\n| **Status** | Still dominant in billing | Officially in effect since Jan 2022 |\n\nThis server defaults to ICD-11 but fully supports both. Use `\"version\": \"10\"` for ICD-10 queries.\n\n---\n\n## Part of the MedSeal MCP Suite\n\n| Server | Classification | Link |\n|--------|---------------|------|\n| **ICD MCP** (this) | WHO ICD-10/ICD-11 diagnosis codes | [icd-mcp-cloudflare](https://github.com/stayce/icd-mcp-cloudflare) |\n| **ICF MCP** | WHO ICF functioning & disability | [icf-mcp-cloudflare](https://github.com/stayce/icf-mcp-cloudflare) |\n| **Part D MCP** | CMS Medicare Part D drug spending | [partd-mcp-cloudflare](https://github.com/stayce/partd-mcp-cloudflare) |\n\nAll deployed on Cloudflare Workers. All open source. All MCP-compatible.\n\n---\n\n## License\n\nMIT\n",
  "bytes": 7334,
  "sha": "b89c857b38e0055f9cf3c63d72824a8ed9d6cd1109fc4c6fc1c2e17705277a73",
  "repo_slug": "stayce/icd-mcp-cloudflare",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_stayce_icd_mcp_cloudflare_icd_classifica_c302548d/readme"
}