ICF

You can run and use an MCP server that provides access to ICF classifications via a Cloudflare Workers deployment. This server exposes an MCP endpoint at a global edge location, allowing you to look up ICF codes, search by keywords, browse categories, retrieve subcategories, explain qualifiers, and view full overviews of the ICF classification.

How to use

You connect your MCP client to the provided endpoint to perform operations such as looking up specific ICF codes (for example b280 or d450), searching by keywords like walking difficulty or pain, or browsing the top-level categories (b, s, d, e). You can also request subcategories for a given code and request explanations of qualifier severities. The server streams results over HTTP, enabling you to integrate this information into your applications, clinical tools, or research workflows.

How to install

Prerequisites you need before installing and running the MCP server:

• WHO ICD-API credentials (free): register at icd.who.int/icdapi

• Cloudflare account with Workers enabled

• Node.js 18+ and npm

How to install

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

How to install

Next set up your local development environment by copying the example environment file and editing it with your credentials.

How to install

cp .dev.vars.example .dev.vars

How to install

For production, store secrets in Cloudflare Workers using the secret management tool.

How to install

wrangler secret put WHO_CLIENT_ID
wrangler secret put WHO_CLIENT_SECRET

How to install

Install dependencies and start the development server locally to verify everything works.

How to install

npm run dev

How to install

The local server will be available at the default development port after startup.

How to install

npm run deploy

How to install

If you are deploying to a custom domain configured in the project, deploy to production with a specific environment.

How to install

wrangler deploy --env production

Additional sections

Configuration notes, security considerations, and practical usage guidance help you operate the MCP server effectively. The server leverages the WHO ICD-API to provide programmatic access to ICD-11 and ICF classifications, enabling you to integrate classification data into your applications with confidence.

Endpoints

The server exposes the following endpoints for MCP protocol interactions and health checks. Use the MCP endpoint to stream data to your client and the root or health path to verify server status.

API Reference

Key API capabilities come from the WHO ICD-API, which provides access to ICD-11 and ICF classifications for integration into your workflows.

License

MIT License - see LICENSE

Related

Related integrations include other MCP server implementations that focus on Claude Desktop or similar clients.

Available tools

icf_lookup

Look up a specific ICF code (e.g., b280, d450) using the MCP protocol endpoint.

icf_search

Search for classifications by keyword such as a symptom or activity (e.g., walking difficulty, pain).

icf_browse_category

Browse top-level ICF categories: body functions (b), body structures (s), activities and participation (d), and environmental factors (e).

icf_get_children

Retrieve subcategories under a given ICF code to navigate the classification hierarchy.

icf_explain_qualifier

Explain severity ratings for qualifiers (0-4, 8, 9) used in ICF entries.

icf_overview

Provide a full overview of the ICF classification system and its structure.