Icd MCP

What icd-mcp MCP server does

The icd-mcp MCP server exposes WHO’s ICD-10 and ICD-11 classification data to MCP-compatible AI clients. It is intended for developers building clinical applications, EHR features, coding assistants, health data tools, or research workflows that need diagnosis-code information from the WHO ICD API.

ICD-11 is the default version. ICD-10 requests can be selected with "version": "10". The server can return code definitions, coding notes, inclusions, exclusions, chapter information, hierarchy relationships, and classification summaries. It also provides ICD-11 keyword search and autocoding for free-text clinical descriptions.

How it works

The hosted deployment is available at https://mcp-icd.medseal.app/mcp. An MCP client sends one action request with parameters such as action, code, query, version, chapter, or max_results. The service processes the request using the WHO ICD API and returns structured results to the assistant.

The icd-mcp MCP server groups its functionality into 12 actions rather than exposing a separate tool for every operation. Actions include lookup, search, autocode, browse, chapters, children, ancestors, validate, coding_rules, overview, api, and help.

For example, lookup retrieves details for a known code, while search finds ranked ICD-11 matches from keywords. autocode accepts clinical text and returns a matching ICD-11 code with a confidence value. browse, children, and ancestors support movement through the classification tree. The api action provides access to the underlying WHO API.

Setup and configuration

The quickest setup uses the hosted endpoint. In Claude Desktop, add the URL under an MCP server entry:

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

A self-hosted deployment requires Node.js project installation, WHO API credentials, and Cloudflare Wrangler. Clone the repository, run npm install, register at https://icd.who.int/icdapi, and obtain a WHO Client ID and Secret. Store them as WHO_CLIENT_ID and WHO_CLIENT_SECRET with Wrangler secrets, then run npm run deploy.

Tools and capabilities

• Look up ICD-10 or ICD-11 codes and their related details.
• Search ICD-11 by keyword, optionally filtering by chapter and result count.
• Convert free-text clinical descriptions into suggested ICD-11 codes.
• Browse chapters, parents, children, and complete code lineages.
• Check whether a code exists and whether it is a category or leaf.
• Read guidance on extension codes, clustering, sequencing, dagger/asterisk coding, and postcoordination.
• Request high-level ICD-10 or ICD-11 overviews.

Limitations and notes

WHO API search and autocoding are available for ICD-11; the README marks both as unavailable for ICD-10. The service defaults to ICD-11, so clients should specify version 10 when making ICD-10 requests. Running a private deployment requires separate WHO API credentials, while the hosted endpoint avoids that setup. The repository describes the service as running on Cloudflare Workers and provides an MIT license.