Icf Mcp

io.github.staycePublished by GitHub account staycev1.1.0Updated Oct 25, 2026

WHO ICF codes: lookup, search, hierarchy, qualifiers, and 11 scored clinical assessment instruments.

VerifiedStreamable HTTPWeb executableLocation & LifestyleKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Remote MCP server for WHO ICF functioning codes and clinical assessment instruments, letting an assistant look up, search and score them.

What you can do
Look up, search, browse and navigate ICF codes, including children, parents, siblings, hierarchy chains and functional profiles built from several codes. Read qualifier references, validate codes and parse fully qualified codes. List and inspect 11 clinical assessment instruments with their items, scoring and ICF mappings. Score responses into severity and interpretation, and suggest instruments for a condition, code or domain. Get a classification overview or send a raw WHO API request.
When to use it
Useful when an assistant needs to work with WHO ICF functioning and disability codes, build functional profiles, or apply standardized clinical assessment instruments such as GAD-7, PHQ-9 or WHODAS 2.0 and map results to ICF qualifiers.
Requirements
A remote endpoint; no local install needed. Code and hierarchy actions rely on the WHO ICD-API, which requires free WHO ICD-API credentials (client ID and secret) configured on the server side. Instrument and qualifier actions work without those credentials. Network access to the endpoint is required.
Before you install
The server is a third party and clinical content is informational; scoring and interpretations should not be treated as diagnosis. The raw WHO API action passes arbitrary requests through. Code and hierarchy lookups depend on WHO API credentials held by the server operator, not by you.

Installation

In SourceWeft

  1. Open Icf Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.stayce%2Ficf-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "icf": {
      "type": "http",
      "url": "https://mcp-icf.medseal.app/mcp"
    }
  }
}

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

Tool

A single icf tool with action dispatch (token-efficient). 19 actions:

Codes & Hierarchy

ActionDescription
lookupLook up a specific ICF code (e.g., b280, d450)
searchSearch by keyword (e.g., "walking difficulty", "pain")
browseBrowse a category (b, s, d, e) or sub-chapter (b1, d4, e3)
childrenGet subcategories of a code
parentNavigate up to a code's parent category
siblingsCodes at the same level (same parent)
chainFull hierarchy path from root to a code
profileBuild a functional profile from multiple codes

Qualifiers

ActionDescription
qualifierComponent-specific qualifier reference (b=1, s=3, d=2, e=barrier/facilitator)
validateValidate code format + qualifiers, verify existence in the WHO API
parseParse fully qualified codes (d450.23, s730.312, e120+3)

Clinical Assessment Instruments

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.

ActionDescription
instrumentsList instruments, optionally filtered by domain
instrumentFull spec: items, response options, scoring, ICF mappings
scoreScore responses → severity, interpretation, ICF qualifier
suggestSuggest instruments for a condition, ICF code, or domain
mappingShow an instrument's ICF code mappings

Meta

ActionDescription
overviewFull ICF classification overview
apiRaw WHO API request (escape valve)
helpAction reference with examples

Example call:

json
{"action": "score", "name": "GAD-7", "responses": [1, 2, 1, 0, 1, 2, 1]}

Instrument and qualifier actions are pure logic and work without WHO API credentials; code/hierarchy actions require them.

Prerequisites

  1. WHO ICD-API credentials (free): Register at https://icd.who.int/icdapi
  2. Cloudflare account with Workers enabled
  3. Node.js 18+ and npm

Installation

bash
git clone https://github.com/stayce/icf-mcp-cloudflare.gitcd icf-mcp-cloudflarenpm install

Configuration

  1. Copy the example environment file:

    bash
    cp .dev.vars.example .dev.vars

  2. Edit .dev.vars with your WHO API credentials for local development.

  3. For production, set secrets:

    bash
    wrangler secret put WHO_CLIENT_IDwrangler secret put WHO_CLIENT_SECRET

Development

bash
npm run dev

The server will be available at http://localhost:8787.

Testing

bash
npm test

Regression tests cover instrument scoring (all 11 instruments) and qualifier parsing — pure logic, no WHO API credentials needed.

Deployment

bash
npm run deploy

For custom domain (configured in wrangler.toml):

bash
wrangler deploy --env production

Usage with Claude

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json
{  "mcpServers": {    "icf": {      "type": "url",      "url": "https://mcp-icf.medseal.app/mcp"    }  }}

Or if deploying your own:

json
{  "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.

License

MIT License - see LICENSE

Related

Source: README.md at commit b04b1b7

Tools

1

icf

Parameterscodenamepathcodesqueryactionrequireddomaincategorycomponentconditionqualifierresponses+1 more

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts