The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Icf MCP listing page.
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
The ICF is a WHO classification that complements ICD (diagnosis codes) by describing how health conditions affect a person's functioning in daily life:
A single icf tool with action dispatch (token-efficient). 19 actions:
| Action | Description |
|---|---|
lookup | Look up a specific ICF code (e.g., b280, d450) |
search | Search by keyword (e.g., "walking difficulty", "pain") |
browse | Browse a category (b, s, d, e) or sub-chapter (b1, d4, e3) |
children | Get subcategories of a code |
parent | Navigate up to a code's parent category |
siblings | Codes at the same level (same parent) |
chain | Full hierarchy path from root to a code |
profile | Build a functional profile from multiple codes |
| Action | Description |
|---|---|
qualifier | Component-specific qualifier reference (b=1, s=3, d=2, e=barrier/facilitator) |
validate | Validate code format + qualifiers, verify existence in the WHO API |
parse | Parse fully qualified codes (d450.23, s730.312, e120+3) |
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 |
|---|---|
instruments | List instruments, optionally filtered by domain |
instrument | Full spec: items, response options, scoring, ICF mappings |
score | Score responses → severity, interpretation, ICF qualifier |
suggest | Suggest instruments for a condition, ICF code, or domain |
mapping | Show an instrument's ICF code mappings |
| Action | Description |
|---|---|
overview | Full ICF classification overview |
api | Raw WHO API request (escape valve) |
help | Action reference with examples |
Example call:
Instrument and qualifier actions are pure logic and work without WHO API credentials; code/hierarchy actions require them.
Copy the example environment file:
Edit .dev.vars with your WHO API credentials for local development.
For production, set secrets:
The server will be available at http://localhost:8787.
Regression tests cover instrument scoring (all 11 instruments) and qualifier parsing — pure logic, no WHO API credentials needed.
For custom domain (configured in wrangler.toml):
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Or if deploying your own:
/ or /health - Health check / server info/mcp - MCP protocol endpoint (streamable HTTP)This server uses the WHO ICD-API which provides programmatic access to both ICD-11 and ICF classifications.
MIT License - see LICENSE