ICF MCP Server
This server provides access to the WHO International Classification of Functioning, Disability and Health (ICF) and a library of standardized clinical assessment instruments, primarily for Remote Patient Monitoring (RPM) workflows.
ICF Classification Tools:
Look up specific ICF codes (e.g.,
b280,d450) with definitions, inclusions, and exclusionsSearch by keywords (e.g., "walking difficulty", "pain", "memory")
Browse the four top-level ICF categories: Body Functions (
b), Body Structures (s), Activities & Participation (d), Environmental Factors (e)Retrieve subcategories (children), parent categories, and sibling codes
Get the full hierarchical path/chain for any ICF code
Validate ICF code format, qualifiers, and existence
Parse qualified codes such as
d450.23ore120+3Build a functional profile from multiple ICF codes
Explain qualifier values (0–4, 8, 9) indicating severity of impairment
Get a general overview of the ICF system
Clinical Assessment Instrument Tools:
List available instruments (GAD-7, PHQ-9, RADAI-5, SLEDAI-2K, HAQ-DI, WHODAS 2.0, PROMIS-10, CAT, ODI, NRS Pain, Short FES-I, and more), filterable by domain
View full instrument details: items, response options, scoring, and ICF mappings
Score patient responses to get severity levels, clinical interpretation, and ICF qualifier mappings
Get instrument recommendations based on a condition, ICF code, or domain
Explore how a specific instrument maps to ICF codes by component
RPM Workflow Support:
Design workflows by selecting validated instruments for a condition
Automate scoring and map results to ICF qualifiers for standardized functional status documentation
Access recommended reassessment frequencies for ongoing patient monitoring
Provides access to the WHO International Classification of Functioning, Disability and Health (ICF) via the WHO ICD-API, enabling lookup, search, and browsing of ICF codes and categories.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ICF MCP Server Look up ICF code b280"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ICF MCP Server
A Model Context Protocol (MCP) server that provides access to the WHO International Classification of Functioning, Disability and Health (ICF) via the WHO ICD-API — plus a built-in library of standardized clinical assessment instruments (GAD-7, PHQ-9, RADAI-5, SLEDAI-2K, WHODAS 2.0, and more) mapped to ICF codes for Remote Patient Monitoring (RPM) workflows.
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. It covers:
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: loinc-mcp
Tools
ICF Classification (12 tools)
Tool | Description |
| Look up a specific ICF code (e.g., |
| Search by keyword (e.g., "walking difficulty", "pain") |
| Browse categories and sub-chapters: |
| Get subcategories of a code |
| Navigate up to a code's parent category |
| Find related codes at the same level |
| Full hierarchy path from root to a code |
| Validate format, qualifiers, and existence |
| Parse qualified codes: |
| Build a functional profile from multiple codes |
| Component-specific qualifier reference (b/s/d/e) |
| Full ICF classification overview |
Clinical Assessment Instruments (5 tools)
Tool | Description |
| Catalog of assessment instruments, filterable by domain |
| Full questionnaire: items, options, scoring, ICF mappings |
| Score responses → severity, interpretation, ICF qualifier |
| Match instruments to a condition, ICF code, or domain |
| How an instrument maps to ICF codes by component |
Included Instruments
Instrument | Domain | Items | Use Case |
GAD-7 | Mental Health | 7 | Generalized anxiety screening/monitoring |
PHQ-9 | Mental Health | 9 | Depression severity |
RADAI-5 | Rheumatology | 5 | RA disease activity (patient-reported) |
SLEDAI-2K | Rheumatology | 24 | Lupus disease activity (weighted, 9 organ systems) |
HAQ-DI | Rheumatology | 20 | Functional disability (8 ADL categories) |
WHODAS 2.0 | General Function | 12 | WHO disability assessment (ICF-derived) |
PROMIS-10 | General Health | 10 | Global physical/mental health |
CAT | Respiratory | 8 | COPD impact |
ODI | Pain/MSK | 10 | Low back pain disability |
NRS Pain | Pain | 1 | Rapid pain intensity |
Short FES-I | Geriatrics | 7 | Fear of falling |
Every instrument includes full item text, response scales, validated scoring algorithms (including SLEDAI-2K organ-system weights and HAQ-DI category scoring), score interpretation ranges, ICF qualifier mappings, and recommended RPM reassessment frequency.
Prerequisites
WHO ICD-API credentials (free): Register at https://icd.who.int/icdapi
Python 3.11+
Installation
# Clone the repository
git clone https://github.com/stayce/icf-mcp-server.git
cd icf-mcp-server
# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -e .Configuration
Create a .env file with your WHO API credentials:
cp .env.example .env
# Edit .env with your credentialsUsage with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"icf": {
"command": "/path/to/icf-mcp-server/.venv/bin/python",
"args": ["-m", "icf_mcp"],
"env": {
"WHO_ICD_CLIENT_ID": "your_client_id",
"WHO_ICD_CLIENT_SECRET": "your_client_secret"
}
}
}
}Restart Claude Desktop to load the server.
Example Queries
Once configured, you can ask Claude:
ICF classification:
"Look up ICF code b280"
"Search ICF for walking difficulties"
"What are the subcategories under d4 (Mobility)?"
"Parse the qualified code d450.23"
"Build an ICF profile from b280, d450, and e120"
"Show the hierarchy chain for b28010"
Clinical assessment:
"What instruments are available for rheumatoid arthritis?"
"Show me the GAD-7 questionnaire"
"Score this PHQ-9: 2,2,1,2,1,1,2,0,0"
"Score a SLEDAI with arthritis, rash, and fever present"
"Which ICF codes does WHODAS 2.0 map to?"
"Suggest an instrument for monitoring pain (b280)"
Remote Patient Monitoring (RPM)
This server is designed to support RPM questionnaire workflows:
Design —
icf_suggest_instrumentspicks validated instruments for a condition;icf_instrument_detailsprovides the exact items and response scales for your questionnaire platformScore —
icf_score_instrumentconverts patient responses into severity levels with clinical interpretationCode — Scores map to ICF qualifiers automatically;
icf_build_profiledocuments functional status in standard ICF termsMonitor — Each instrument includes a recommended RPM reassessment frequency
Development
# Install in development mode
pip install -e ".[dev]"
# Run tests
python -m pytest
# Test the client directly
python -c "
import asyncio
from icf_mcp.who_client import WHOICFClient
async def test():
client = WHOICFClient(client_id='...', client_secret='...')
results = await client.search('pain')
print(results)
await client.close()
asyncio.run(test())
"Related Projects
icd-mcp-cloudflare — WHO ICD-10/ICD-11 MCP server (Cloudflare Workers)
icf-mcp-cloudflare — ICF MCP server for Cloudflare Workers
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
Disclaimer
Assessment instruments are provided for informational and workflow-support purposes. Scoring and interpretation ranges follow published literature but do not replace clinical judgment. Instrument copyrights belong to their respective authors; verify licensing requirements for commercial use (e.g., HAQ-DI, CAT).
License
MIT License - see LICENSE
Contributing
Contributions welcome! Please open an issue or submit a pull request.
Acknowledgments
World Health Organization for the ICD-API and ICF classification
Anthropic for the Model Context Protocol
Instrument authors: Spitzer et al. (GAD-7), Kroenke et al. (PHQ-9), Leeb et al. (RADAI-5), Gladman et al. (SLEDAI-2K), Üstün et al. (WHODAS 2.0), Fries et al. (HAQ-DI), Hays et al. (PROMIS), Jones et al. (CAT), Fairbank & Pynsent (ODI), Kempen et al. (Short FES-I)
Available Tools
17 toolsicf_browse_categoryA
Browse an ICF category or sub-chapter to explore available codes.
Accepts top-level components or sub-chapter codes:
"b", "s", "d", "e": Top-level components
"b1": Mental functions chapter
"b2": Sensory functions and pain
"d4": Mobility chapter
"e1": Products and technology
Any valid sub-chapter code (e.g., "b1", "s7", "d45", "e3")
Args: category: Component letter (b, s, d, e) or sub-chapter code (b1, d4, etc.)
Returns: Overview of the category/sub-chapter with child codes.
Inputs: category (required). Returns: result
icf_build_profileA
Build an ICF functional profile from multiple codes.
Creates a structured summary organizing multiple ICF codes by component, useful for documenting a person's functional status across body functions, structures, activities, and environmental factors.
Args: codes: List of ICF codes (e.g., ["b280", "d450", "e120"])
Returns: Structured ICF profile organized by component.
Inputs: codes (required). Returns: result
icf_explain_qualifierA
Explain ICF qualifier systems. Each ICF component uses different qualifiers.
ICF qualifier types vary by component:
Body Functions (b): 1 qualifier — extent of impairment (0-4)
Body Structures (s): 3 qualifiers — extent, nature of change, location
Activities & Participation (d): 2 qualifiers — performance, capacity
Environmental Factors (e): 1 qualifier — barrier (0-4) or facilitator (+0 to +4)
Args: component: Component to explain qualifiers for. One of: "generic" (default severity scale), "b" (body functions), "s" (body structures), "d" (activities & participation), "e" (environmental factors) qualifier: Optional specific qualifier value to explain (0-9). If omitted, shows all qualifiers for the component.
Returns: Explanation of qualifier system for the specified component.
Inputs: component, qualifier. Returns: result
icf_get_childrenA
Get the child codes (subcategories) of an ICF code.
ICF codes are hierarchical. For example:
d4 (Mobility) contains d410-d499
d45 (Walking and moving) contains d450-d459
d450 (Walking) is a specific activity
Use this to drill down into more specific codes.
Args: code: Parent ICF code to get children for
Returns: List of child codes under the specified parent.
Inputs: code (required). Returns: result
icf_get_code_chainA
Show the full hierarchical path from the ICF root down to a specific code.
Displays the complete classification chain as a breadcrumb trail, useful for understanding where a code sits in the overall ICF structure. For example, d4501 might show: Activities and Participation → Mobility → Walking and moving → Walking → Walking long distances.
Args: code: ICF code to trace (e.g., "b2801", "d4501")
Returns: Hierarchical chain from root to the specified code.
Inputs: code (required). Returns: result
icf_get_parentA
Get the parent category of an ICF code to navigate up the hierarchy.
ICF codes are hierarchical. Use this to move from a specific code up to its broader category. For example:
d4501 → d450 (Walking)
d450 → d45 (Walking and moving)
d45 → d4 (Mobility)
Args: code: ICF code to find the parent of (e.g., "d450", "b2801")
Returns: Parent code details and the relationship to the child code.
Inputs: code (required). Returns: result
icf_get_siblingsA
Get sibling codes — other codes at the same level sharing the same parent.
Useful for finding related or alternative codes. For example, siblings of d450 (Walking) include d455 (Moving around) and d460 (Moving around in different locations).
Args: code: ICF code to find siblings for (e.g., "d450", "b280")
Returns: List of sibling codes with titles.
Inputs: code (required). Returns: result
icf_instrument_detailsA
Get full details of a clinical assessment instrument.
Shows all questionnaire items, response options, scoring method, score interpretation ranges, and ICF code mappings.
Args: name: Instrument name or abbreviation (e.g., "GAD-7", "PHQ-9", "RADAI-5", "SLEDAI", "WHODAS", "HAQ", "ODI", "CAT", "NRS")
Returns: Complete instrument specification.
Inputs: name (required). Returns: result
icf_instrument_icf_mappingA
Show how an assessment instrument maps to ICF codes.
Displays all ICF codes linked to an instrument, organized by relationship type (primary, secondary, related), with code descriptions.
Args: name: Instrument name or abbreviation (e.g., "GAD-7", "SLEDAI", "WHODAS")
Returns: ICF code mappings organized by relationship type.
Inputs: name (required). Returns: result
icf_list_instrumentsA
List available standardized assessment instruments.
Instruments are clinical questionnaires (GAD-7, PHQ-9, RADAI-5, SLEDAI, WHODAS 2.0, etc.) used for RPM patient assessment, each mapped to ICF codes.
Args: domain: Optional filter by domain (e.g., "Mental Health", "Rheumatology", "Pain", "Respiratory", "General"). Leave empty for all instruments.
Returns: Table of available instruments with key details.
Inputs: domain. Returns: result
icf_lookupA
Look up an ICF code and get its full details.
The ICF (International Classification of Functioning, Disability and Health) codes describe how health conditions affect functioning. Code prefixes:
b: Body Functions (e.g., b280 = sensation of pain)
s: Body Structures (e.g., s750 = structure of lower extremity)
d: Activities and Participation (e.g., d450 = walking)
e: Environmental Factors (e.g., e120 = assistive products for mobility)
Args: code: The ICF code to look up (e.g., "b280", "d450")
Returns: Detailed information about the ICF code including definition, inclusions, and exclusions.
Inputs: code (required). Returns: result
icf_overviewA
Get an overview of the ICF classification system.
Returns: General information about ICF, its structure, and how to use it.
Inputs: no named parameters. Returns: result
icf_parse_qualified_codeA
Parse a fully qualified ICF code and explain each qualifier component.
Qualified ICF codes encode severity/characteristics after the base code:
b280.2 → Body Functions: moderate impairment
d450.23 → Activities: performance=moderate, capacity=severe
s730.312 → Structures: severe extent, total absence, right side
e120.2 → Environment: moderate barrier
e120+3 → Environment: substantial facilitator
Args: code: Fully qualified ICF code (e.g., "d450.23", "s730.312", "e120+3")
Returns: Detailed breakdown of the code and all qualifier values.
Inputs: code (required). Returns: result
icf_score_instrumentA
Score a completed assessment instrument and get clinical interpretation.
Pass the instrument name and a list of integer responses (one per item, in order). Returns total score, severity level, ICF qualifier mapping, and clinical guidance.
Args: name: Instrument name or abbreviation (e.g., "GAD-7", "PHQ-9", "SLEDAI") responses: List of response values, one per item in order (e.g., [1, 2, 1, 0, 1, 2, 1] for GAD-7)
Returns: Scored result with interpretation and ICF qualifier mapping.
Inputs: name (required), responses (required). Returns: result
icf_searchA
Search the ICF classification by keywords or description.
Use this to find ICF codes when you know what functional area you're looking for but don't know the specific code. For example:
"walking" to find mobility-related codes
"pain" to find pain-related body function codes
"memory" to find cognitive function codes
Args: query: Search terms (e.g., "walking difficulty", "memory problems") max_results: Maximum number of results to return (default 10)
Returns: List of matching ICF codes with titles and relevance scores.
Inputs: query (required), max_results. Returns: result
icf_suggest_instrumentsB
Suggest appropriate assessment instruments for a condition, ICF code, or domain.
Finds instruments relevant to a clinical condition (e.g., "rheumatoid arthritis"), a specific ICF code (e.g., "b280" for pain), or a clinical domain (e.g., "Mental Health").
Args: condition: Clinical condition (e.g., "rheumatoid arthritis", "depression", "COPD") icf_code: ICF code to match against instrument mappings (e.g., "b280", "d450") domain: Clinical domain (e.g., "Mental Health", "Rheumatology", "Pain")
Returns: List of suggested instruments with rationale.
Inputs: domain, icf_code, condition. Returns: result
icf_validate_codeA
Validate an ICF code — check format, qualifiers, and verify it exists.
Supports both base codes and fully qualified codes with qualifiers:
Base: "b280", "d4501"
Qualified: "b280.2", "d450.23", "s730.312", "e120+3"
Args: code: ICF code to validate (e.g., "b280", "d450.23", "s730.312")
Returns: Code analysis with format validation, qualifier breakdown, and API verification.
Inputs: code (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool has a uniquely defined purpose: lookup, search, validate, navigate hierarchy (children, parent, siblings, chain), explain qualifiers, parse qualified codes, browse categories, build profiles, and instrument management (list, details, mapping, scoring, suggestion). No two tools overlap in functionality, enabling agents to select the correct tool unambiguously.
All tools share the 'icf_' prefix and most follow a verb_noun pattern (e.g., 'icf_browse_category', 'icf_get_children', 'icf_search'). However, 'icf_instrument_details' and 'icf_instrument_icf_mapping' are noun phrases, and 'icf_overview' is just a noun, breaking the pattern. Minor inconsistency in a largely consistent set.
With 17 tools, the server covers all essential ICF operations—navigation, search, validation, qualifier handling, and instrument management—without being excessive. Each tool serves a distinct need, and the count feels appropriate for the domain's complexity.
The tool surface is comprehensive for an ICF classification server: it includes lookup, search, validation, full hierarchy navigation (children, parent, siblings, chain), qualifier explanation and parsing, profile building, and instrument-related operations (listing, details, mapping, scoring, suggestion). No obvious gaps exist for typical use cases.
Maintenance
Related MCP Connectors
WHO ICD-10/ICD-11 diagnosis codes. Lookup, search, chapters via official WHO API.
WHO ICF codes: lookup, search, hierarchy, qualifiers, and 11 scored clinical assessment instruments.
Offline US medical code lookup and crosswalk — ICD-10-CM/PCS, HCPCS Level II, RxNorm. Keyless.
Polish ICD-10, ICD-9 PL, ICD-11 PL codes and NFZ JGP hospital grouping from official sources.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying and browsing SNOMED CT medical terminology concepts, including search, details, and hierarchy navigation via MCP tools.3MIT
- AlicenseAqualityDmaintenanceEnables searching LOINC codes and retrieving detailed information including panel members and answer options via the LOINC Search API.21MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants instant access to WHO ICD-10 and ICD-11 classification systems for code lookup, search, autocoding, validation, and hierarchy browsing via 12 tool actions.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the WHO International Classification of Functioning, Disability and Health (ICF) with tools for code lookup, search, and clinical instrument scoring, deployed on Cloudflare Workers.1MIT