ICF MCP Server (Cloudflare Workers)
ICF MCP Server (Cloudflare Workers)
A Model Context Protocol (MCP) server for the WHO International Classification of Functioning, Disability and Health (ICF), deployed on Cloudflare Workers for global edge availability.
Live URL: https://mcp-icf.medseal.app/mcp
What is ICF?
The ICF is a WHO classification that complements ICD (diagnosis codes) by describing how health conditions affect a person's functioning in daily life:
Body Functions (b) - Physiological and psychological functions
Body Structures (s) - Anatomical parts of the body
Activities and Participation (d) - Task execution and life involvement
Environmental Factors (e) - Physical, social, and attitudinal environment
Related MCP server: Medical Terminologies MCP
Tool
A single icf tool with action dispatch (token-efficient). 19 actions:
Codes & Hierarchy
Action | Description |
| Look up a specific ICF code (e.g., |
| Search by keyword (e.g., "walking difficulty", "pain") |
| Browse a category ( |
| Get subcategories of a code |
| Navigate up to a code's parent category |
| Codes at the same level (same parent) |
| Full hierarchy path from root to a code |
| Build a functional profile from multiple codes |
Qualifiers
Action | Description |
| Component-specific qualifier reference ( |
| Validate code format + qualifiers, verify existence in the WHO API |
| Parse fully qualified codes ( |
Clinical Assessment Instruments
11 standardized RPM instruments with items, scoring, and ICF mappings: GAD-7, PHQ-9, RADAI-5, SLEDAI-2K, WHODAS 2.0, HAQ-DI, PROMIS-10, CAT, ODI, NRS Pain, Short FES-I.
Action | Description |
| List instruments, optionally filtered by domain |
| Full spec: items, response options, scoring, ICF mappings |
| Score responses → severity, interpretation, ICF qualifier |
| Suggest instruments for a condition, ICF code, or domain |
| Show an instrument's ICF code mappings |
Meta
Action | Description |
| Full ICF classification overview |
| Raw WHO API request (escape valve) |
| Action reference with examples |
Example call:
{"action": "score", "name": "GAD-7", "responses": [1, 2, 1, 0, 1, 2, 1]}Instrument and qualifier actions are pure logic and work without WHO API credentials; code/hierarchy actions require them.
Prerequisites
WHO ICD-API credentials (free): Register at https://icd.who.int/icdapi
Cloudflare account with Workers enabled
Node.js 18+ and npm
Installation
git clone https://github.com/stayce/icf-mcp-cloudflare.git
cd icf-mcp-cloudflare
npm installConfiguration
Copy the example environment file:
cp .dev.vars.example .dev.varsEdit
.dev.varswith your WHO API credentials for local development.For production, set secrets:
wrangler secret put WHO_CLIENT_ID wrangler secret put WHO_CLIENT_SECRET
Development
npm run devThe server will be available at http://localhost:8787.
Testing
npm testRegression tests cover instrument scoring (all 11 instruments) and qualifier parsing — pure logic, no WHO API credentials needed.
Deployment
npm run deployFor custom domain (configured in wrangler.toml):
wrangler deploy --env productionUsage with Claude
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"icf": {
"type": "url",
"url": "https://mcp-icf.medseal.app/mcp"
}
}
}Or if deploying your own:
{
"mcpServers": {
"icf": {
"type": "url",
"url": "https://your-worker.workers.dev/mcp"
}
}
}Endpoints
/or/health- Health check / server info/mcp- MCP protocol endpoint (streamable HTTP)
API Reference
This server uses the WHO ICD-API which provides programmatic access to both ICD-11 and ICF classifications.
API Documentation: https://icd.who.int/docs/icd-api/APIDoc-Version2/
ICF Browser: https://icd.who.int/dev11/l-icf/en
License
MIT License - see LICENSE
Related
icf-mcp-server - Python version for Claude Desktop
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Cloudflare Workers MCP server: a11y-scorer
Cloudflare Workers MCP server: citation-verifier
Free hosted MCP server: US healthcare procedure cost estimates and provider pricing. No API key.
MCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for automated ICD-10 medical coding. Code clinical text to ICD-10-CM diagnoses, search 74,000+ codes, and de-identify PHI via the AutoICD API.632 npmMIT
- AlicenseAqualityBmaintenanceUnified MCP server providing LLMs with reliable lookup access to ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10, and (optionally) SNOMED CT.33277 npm16MIT
- FlicenseNot gradedqualityDmaintenanceA universal MCP server providing calculator and API calling tools, deployable on Cloudflare Workers.-
- AlicenseAqualityFmaintenanceMCP server for Brazilian ICD-10 (CID-10) that enables search, lookup, hierarchy navigation, statistics, and validation of disease codes from official DATASUS data.695 npm1MIT