# Emotional Variability MCP > Emotional Variability Score lets you quantify mood swings and stability over time. It measures emotional amplitude—the distance between peak highs and deep lows—and calculates instability indices. This helps track if emotional fluctuations are increasing or decreasing week-over-week, giving stakeholders a precise view of behavioral trends. ## Overview - **Category:** analytics - **Price:** Free - **Tags:** mood, stability, volatility, emotion, metrics ## Description You can't just guess at how stable an emotional pattern is; you need metrics. This MCP provides specialized methods for charting mood changes and identifying patterns in behavioral data. Instead of sifting through charts to see if the peaks are getting bigger or the dips are getting deeper, your agent handles the math. You can quickly quantify exactly how erratic a person's mood swings are within any given timeframe. Need to know if stability is trending up or down? You can compare weekly volatility directly and get an immediate trend line. For a full picture, you run the complete emotional report which aggregates all metrics into one summary view. When you connect this MCP via Vinkius, your agent becomes a powerful behavioral analyst right inside your workflow. ## Tools ### compare_weekly_volatility Compares two consecutive weeks to determine if emotional instability is worsening or getting better. ### calculate_mood_amplitude Identifies the extremes of the emotional range—the highest peak and lowest valley—experienced during a time period. ### calculate_instability_index Quantifies how erratic or frequent mood swings are within a specific date range, returning an index score and pattern type. ### get_comprehensive_emotional_report Generates a high-level summary of all emotional metrics for a given period, including stability status and overall rating. ## Prompt Examples **Prompt:** ``` Calculate the instability index for the period between 2023-10-01 and 2023-10-07. ``` **Response:** ``` The `calculate_instability_index` tool would return the instability score and pattern type for that specific week. ``` **Prompt:** ``` What was the peak and valley mood score between 2023-10-01 and 2023-10-31? ``` **Response:** ``` The `calculate_mood_amplitude` tool would return the peak value, valley value, and the total range scale for October. ``` **Prompt:** ``` Generate an emotional report for the first week of November 2023. ``` **Response:** ``` The `get_comprehensive_emotional_report` tool would provide a summary including instability status, amplitude range, and an overall stability rating. ``` ## Capabilities ### Determine overall stability status Generate an aggregated status and rating summarizing emotional health across the entire period. ### Measure peak mood range Identify the absolute highest and lowest points experienced during a specific time window. ### Quantify erratic behavior rates Calculate an index that measures how frequent or intense mood swings are within a set date range. ### Track changes in volatility trends Compare the emotional instability between two consecutive weeks to determine if the trend is worsening or improving. ## Use Cases ### Tracking Client Progress A coach needs to know if a client's emotional management techniques are working. Instead of subjective feedback, the agent runs compare_weekly_volatility and compares two months of data. The resulting delta shows a clear trend toward lower volatility, providing measurable proof of improvement. ### Incident Review A team needs to review performance during a known crisis period. They run get_comprehensive_emotional_report for the full month and then use calculate_mood_amplitude to isolate exactly how deep the lowest point was, helping pinpoint when support failed. ### Identifying Behavioral Triggers A researcher wants to know if a specific event caused mood swings. They run calculate_instability_index for the period before and after the event. A sharp spike in the index pinpoints the potential trigger with quantitative evidence. ### Board Reporting Executives need a quick status check without digging into raw numbers. They ask the agent to run get_comprehensive_emotional_report for Q2, getting an immediate stability rating and summary of all key metrics in one actionable view. ## Benefits - Pinpoint when stability is slipping. Use compare_weekly_volatility to get a trend showing if emotional volatility is increasing or decreasing week-over-week. - Understand the scope of mood dips. Running calculate_mood_amplitude reveals the absolute peak value, valley value, and total range for any given period. - Pinpoint erratic behavior rates. The calculate_instability_index tool quantifies how frequently or sharply mood swings happen within a specific date window. - Get an immediate overview. Instead of running four different reports, use get_comprehensive_emotional_report to pull together stability status, range, and rating in one shot. - Identify the source of risk. By pairing calculate_instability_index with compare_weekly_volatility, you can see if high instability is leading to worsening volatility. ## How It Works The bottom line is that you get quantitative evidence about mood swings, not just subjective feelings. 1. You tell your AI client the specific time frame you need evaluated, like 'October 1st through October 31st'. 2. Your agent then selects and runs the appropriate tool—for example, to get a summary report or compare two weeks of data. 3. The MCP returns structured metrics, giving you concrete scores for instability, amplitude range, and stability status. ## Frequently Asked Questions **How do I use calculate_instability_index?** You run this tool by providing a specific start and end date range. It returns an instability score and pattern type, letting you quantify how erratic the mood swings are during that week. **What's the difference between calculate_mood_amplitude and get_comprehensive_emotional_report?** calculate_mood_amplitude only gives you the peak/valley range. The comprehensive report pulls all metrics together, giving you a full summary, stability status, and overall rating. **Can I track weekly changes with compare_weekly_volatility?** Yes. You run this tool by specifying two consecutive weeks. It returns the delta and trend, telling you if volatility is worsening or improving compared to last week. **Do I need all four tools for an emotional report?** No. If you just need a summary overview, get_comprehensive_emotional_report handles that. Use the other tools if you need deeper dives into specific metrics like amplitude or volatility. **What date format must I use when calling calculate_instability_index?** You must provide dates in YYYY-MM-DD format. The tool requires a clear start and end date to map the correct emotional period for analysis. **What happens if my dataset is incomplete when using calculate_mood_amplitude?** If data is missing, the tool returns null values for the affected metrics. Always check your source data first; it's best to fill in gaps before running amplitude checks. **Are there limitations if I run get_comprehensive_emotional_report frequently?** While we don't impose strict limits, frequent large requests can hit rate caps. Break down your analysis into smaller reporting chunks to keep things running smoothly. **What kind of scores are needed for compare_weekly_volatility?** The tool requires standardized numerical scores from both weeks being compared. Ensure all emotional metrics you use have the same scale and data type. **What does the instability index measure?** The `calculate_instability_index` tool measures how frequently your mood changes direction, providing a score that represents the frequency of transitions between different emotional states. **How is amplitude calculated?** The `calculate_mood_amplitude` tool calculates the vertical distance between the highest (peak) and lowest (valley) mood scores recorded during your specified timeframe. **Can I compare two different weeks?** Yes, use the `compare_weekly_volatility` tool by providing the start dates for both the current and previous weeks to see if your emotional stability is trending up or down.