Skip to main content
Glama

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

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 categories and sub-chapters: b, d4, e3, etc.

icf_get_children

Get subcategories of a code

icf_get_parent

Navigate up to a code's parent category

icf_get_siblings

Find related codes at the same level

icf_get_code_chain

Full hierarchy path from root to a code

icf_validate_code

Validate format, qualifiers, and existence

icf_parse_qualified_code

Parse qualified codes: d450.23, s730.312, e120+3

icf_build_profile

Build a functional profile from multiple codes

icf_explain_qualifier

Component-specific qualifier reference (b/s/d/e)

icf_overview

Full ICF classification overview

Clinical Assessment Instruments (5 tools)

Tool

Description

icf_list_instruments

Catalog of assessment instruments, filterable by domain

icf_instrument_details

Full questionnaire: items, options, scoring, ICF mappings

icf_score_instrument

Score responses → severity, interpretation, ICF qualifier

icf_suggest_instruments

Match instruments to a condition, ICF code, or domain

icf_instrument_icf_mapping

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

  1. WHO ICD-API credentials (free): Register at https://icd.who.int/icdapi

  2. 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 credentials

Usage 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:

  1. Design — icf_suggest_instruments picks validated instruments for a condition; icf_instrument_details provides the exact items and response scales for your questionnaire platform

  2. Score — icf_score_instrument converts patient responses into severity levels with clinical interpretation

  3. Code — Scores map to ICF qualifiers automatically; icf_build_profile documents functional status in standard ICF terms

  4. Monitor — 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())
"

API Reference

This server uses the WHO ICD-API which provides programmatic access to both ICD-11 and ICF classifications.

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 tools
icf_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_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

    A4.1/5.0

    Scored across 17 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying and browsing SNOMED CT medical terminology concepts, including search, details, and hierarchy navigation via MCP tools.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables searching LOINC codes and retrieving detailed information including panel members and answer options via the LOINC Search API.
      2
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      1
      MIT