About io.github.stayce/icf-mcp
io.github.stayce/icf-mcp is an MCP server in the Healthcare category: wHO ICF classification codes for health and disability. Lookup, search, browse via WHO API.
Install
git clone https://github.com/stayce/icf-mcp-cloudflareThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.stayce/icf-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.