Summary
Connects Claude to the WHO International Classification of Functioning, Disability and Health through their official ICD API. Exposes six tools: look up specific codes like b280 or d450, search by keywords, browse the four main categories (body functions, structures, activities, environmental factors), navigate code hierarchies, and decode severity qualifiers. Runs on Cloudflare Workers at the edge, so you get global latency without managing infrastructure. Reach for this when you need to map health conditions to functional impacts, document disability assessments, or build clinical documentation tools that go beyond diagnosis codes to capture how conditions affect daily living.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Tools
| Tool | Description |
|---|---|
icf_lookup | Look up a specific ICF code (e.g., b280, d450) |
icf_search | Search by keyword (e.g., "walking difficulty", "pain") |
icf_browse_category | Browse top-level categories: b, s, d, e |
icf_get_children | Get subcategories of a code |
icf_explain_qualifier | Explain severity ratings (0-4, 8, 9) |
icf_overview | Full ICF classification overview |
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 install
Configuration
-
Copy the example environment file:
cp .dev.vars.example .dev.vars -
Edit
.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 dev
The server will be available at http://localhost:8787.
Deployment
npm run deploy
For custom domain (configured in wrangler.toml):
wrangler deploy --env production
Usage 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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
TransportHTTP
UpdatedJan 21, 2026
