ICD

You can access a Cloudflare Workers MCP server that provides both ICD-10 and ICD-11 code lookups, searches, chapters, and more through a single, purpose-built endpoint. This server connects to the official WHO ICD-API and is designed to be credential-efficient, enabling you to query classifications quickly from anywhere with a minimal setup.

How to use

Use an MCP client to connect to the live endpoint and perform actions such as looking up codes, listing chapters, or retrieving raw API data from the WHO ICD API. The server supports both ICD-10 and ICD-11, with actions that let you retrieve details for specific codes, list related chapters, or fetch subcodes.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You also need access to a Cloudflare Workers environment if you plan to deploy your own instance.

1. Clone the project repository.

2. Install dependencies.

3. Acquire WHO API credentials. Register at the WHO ICD API portal and obtain a Client ID and Client Secret.

4. Configure credentials in your deployment environment. You will set the WHO_CLIENT_ID and WHO_CLIENT_SECRET secrets for the server.

5. Deploy your MCP server to Cloudflare Workers using the deployment command shown in the guide.

Additional content

Usage notes and examples help you perform common tasks quickly. The server exposes six actions to cover common needs: lookup, search, chapters, children, api, and help. The live endpoint is publicly accessible at the specified URL, and you can reuse the same credentials as the related MCP server for ICF.

Examples and quick start

{"action": "lookup", "code": "BA00"}
{"action": "lookup", "code": "J18.9", "version": "10"}
{"action": "search", "query": "pneumonia"}
{"action": "chapters"}
"""}

Security and credentials

Your deployment requires WHO API credentials to access ICD data. For personal testing, you can deploy your own instance with the appropriate credentials. Keep Client ID and Client Secret secure and do not expose them in client-side code.

Available tools

lookup

Retrieve details for a specific ICD code, for both ICD-10 and ICD-11.

search

Find codes by keyword. ICD-10 search is not supported by WHO API; ICD-11 search is supported.

chapters

List ICD chapters available for lookup and navigation.

children

Get subcodes or child entries for a given code.

api

Access the raw WHO API data for advanced needs.

help

Provide documentation-style guidance and usage help for the MCP server.