# WHO-5 Wellbeing Index MCP > WHO-5 Wellbeing Index calculates psychological well-being scores using the World Health Organization's validated scale. Input five responses (0-5) through this MCP, and you get a normalized score from 0 to 100, along with immediate risk indicators for your client's mental state. It also includes tools to validate scores or reference the official scale mapping. ## Overview - **Category:** health - **Price:** Free - **Tags:** who-5, wellbeing, mental-health, screening, psychology ## Description Need to quantify psychological well-being? This connector provides specialized methods built around the World Health Organization's WHO-5 scale. Instead of relying on vague qualitative reports, you get a precise number and an immediate risk assessment. The process starts with understanding the source material; one tool lets you fetch the official instructions for the scale mapping. Once you have that context, simply input five responses, and the system calculates your wellbeing score and provides a classification. You can then run a final check to ensure the resulting score falls within the expected 0-100 bounds before reporting it. By connecting this MCP via Vinkius, you give your AI client a specialized tool for mental health data that just works. ## Tools ### validate_assessment_range Checks if a score is within the mathematically valid 0 to 100 range. ### calculate_wellbeing_assessment Takes five user responses and calculates the final WHO-5 Well-Being Index score. ### fetch_scale_instructions Provides detailed context about what each number on the scale (0 through 5) represents. ## Prompt Examples **Prompt:** ``` Calculate my wellbeing score with these responses: 5, 4, 5, 4, 5. ``` **Response:** ``` The `calculate_wellbeing_assessment` tool would return a score of 90, indicating Normal Wellbeing with no high-risk indicators detected. ``` **Prompt:** ``` What does the scale mapping look like? ``` **Response:** ``` By using `fetch_scale_instructions`, you can see that 0 represents 'Never' and 5 represents 'All the time'. ``` **Prompt:** ``` Is a score of 45 valid? ``` **Response:** ``` The `validate_assessment_range` tool would confirm that 45 is within the valid range (0-100), though it indicates a low wellbeing state. ``` ## Capabilities ### Calculate Wellbeing Scores Inputs five responses and returns the official WHO-5 normalized score (0-100) along with risk indicators. ### Assess Risk Level Automatically identifies if a client's score suggests normal, low, or high psychological risk based on established guidelines. ### Validate Score Integrity Checks any given number to confirm it falls within the standard 0-100 scoring range, preventing data errors. ### Retrieve Scale Context Provides clear instructions on how each numerical response (0 through 5) maps to a specific level of well-being. ## Use Cases ### Intake Screening for New Patients A clinic needs to process 50 new patient intake forms. Instead of having staff manually score every sheet, they send the responses to their agent. The agent uses `calculate_wellbeing_assessment` to generate a batch report showing individual scores and flagging anyone who falls below a safe threshold. ### Validating Research Data Sets A research team collects data from various sources, making sure some scores are accidentally outside the 0-100 range. They run every score through `validate_assessment_range` to filter out bad inputs before analysis. ### Building a Client Dashboard A software developer builds a wellness app. Before calculating a user's score, they first call `fetch_scale_instructions` to ensure their internal logic matches the World Health Organization’s current mapping rules. ### Quick Clinical Consultations A specialist needs an instant read on a patient. They input the five responses directly into the MCP, using `calculate_wellbeing_assessment` to get both the score and the specific risk indicator in seconds. ## Benefits - Get immediate risk assessment. The core function instantly classifies the score, telling you if the client is in normal or high-risk range. This saves time compared to manual guideline reviews. - Ensure data integrity with `validate_assessment_range`. You can confirm any resulting number falls within the expected 0–100 bounds before building a report. - Maintain clinical accuracy by using `fetch_scale_instructions`. You always know that 'Never' maps to zero and 'All the time' maps to five, removing ambiguity. - Standardize intake. Instead of writing narrative assessments, you get one concrete metric—the WHO-5 score—for comparison across patients or studies. - Build robust workflows. By chaining `fetch_scale_instructions` into `calculate_wellbeing_assessment`, your agent handles the entire scoring lifecycle reliably. ## How It Works The bottom line is, it moves mental health assessment from subjective narrative reports to concrete, actionable metrics. 1. First, use the scale instruction tool to get context. This confirms exactly what responses like 'Never' or 'All the time' mean numerically. 2. Next, pass five user responses into the calculation function. The MCP runs the scoring algorithm and returns a score, classification, and risk assessment. 3. Finally, if you need absolute certainty, use the validation tool to confirm that the calculated number sits correctly between 0 and 100. ## Frequently Asked Questions **How do I use calculate_wellbeing_assessment?** You pass five numeric responses (0–5) to this tool. It returns a normalized score from 0 to 100, along with whether the result indicates low or high risk. **What is fetch_scale_instructions used for?** This tool provides the clinical context for the WHO-5 scale. It tells you exactly what 'Never' means numerically and how each response maps to a specific level of well-being. **Can I check if my score is valid using validate_assessment_range?** Yes, calling `validate_assessment_range` confirms that any number you calculate falls within the required 0–100 standard bounds. It's a quick data integrity check. **Is this MCP good for research purposes?** Absolutely. Because it uses WHO-5 standards, it gives your agent reliable, quantifiable metrics suitable for cohort analysis and research reporting. **If I input bad data, how does `calculate_wellbeing_assessment` handle it?** The tool requires five inputs that are integers between 0 and 5. If you include text or numbers outside this range, the function will fail cleanly and tell you exactly which response needs correction. **What does `calculate_wellbeing_assessment` return besides just a number?** The output includes more than just the score. You'll get a specific wellbeing classification, like 'Normal Wellbeing,' and it also provides indicators for high-risk areas. **Does using `validate_assessment_range` require any special setup or permissions?** No. Validating a score is a simple read function that doesn't need extra client permissions. You just pass the number, and it confirms if 0-100 bounds are met. **If I'm confused about the scale meanings, how can `fetch_scale_instructions` clarify things?** `fetch_scale_instructions` gives you full context on the WHO-5 scale. It maps out what each number (0 through 5) represents in terms of frequency or experience. **What is the WHO-5 Well-Being Index?** The WHO-5 is a screening tool used to assess subjective psychological well-being based on how an individual has felt over the last two weeks. **How do I interpret the score?** The score is normalized to a 0-100 scale. A score below 50 is considered a significant indicator of potential low well-being. **What inputs are required for the assessment?** You need to provide five numeric responses, each ranging from 0 (never) to 5 (all the time), corresponding to the five questions in the scale.