# Recovery Readiness Score MCP > Recovery Readiness Score calculates a data-backed training intensity recommendation using your sleep quality, soreness levels, stress metrics, and motivation. It tells you if you can crush a heavy workout or if you need an active rest day based on how recovered your body really is. ## Overview - **Category:** analytics - **Price:** Free - **Tags:** training, recovery, fitness-tracking, biometrics, performance ## Description This MCP gives trainers and athletes objective data to guide their workouts. Instead of guessing whether to push harder or take it easy, the system synthesizes multiple markers—things like how long you slept versus how sore your quads are—to generate a single readiness score. You get an immediate recommendation on training intensity, ranging from heavy lifting days down to complete rest. It also helps pinpoint exactly which muscle group is limiting your progress right now, so you don't waste time training muscles that are already fine. Connecting this MCP through Vinkius lets your AI client access these sophisticated insights directly inside your existing workflow. ## Tools ### calculate_readiness_score Calculates your overall training readiness score and determines the recommended workout intensity for the day. ### get_soreness_impact_analysis Analyzes specific muscle groups to pinpoint which ones are most sore and potentially limiting current performance. ### validate_recovery_metrics Checks your input data against known physiological ranges to ensure the metrics used for scoring are accurate. ## Prompt Examples **Prompt:** ``` I slept 7 hours with good quality, but my legs and chest are very sore (8/10). My stress is low (2) and motivation is high (9). I had a heavy session 2 days ago. How should I train today? ``` **Response:** ``` Based on your metrics, your recovery score is approximately 65. Due to high soreness in your legs and chest and the recent heavy session, your recommended training intensity for today is 'Light'. ``` **Prompt:** ``` Check if my recovery metrics are valid: sleep 8 hours, quality 9, stress 5, motivation 7. ``` **Response:** ``` Yes, all provided metrics are within the valid physiological and psychological ranges. ``` **Prompt:** ``` Analyze this soreness: {'Legs': 9, 'Back': 2, 'Chest': 1}. ``` **Response:** ``` The critical muscle group identified is Legs. The high soreness level suggests localized fatigue that may limit your training intensity. ``` ## Capabilities ### Determine optimal workout intensity Gets a comprehensive score and advises on whether today should be heavy, moderate, or an active rest day. ### Identify limiting muscle groups Analyzes soreness data to show which specific muscles are causing performance bottlenecks. ### Verify biometric inputs Checks your collected recovery numbers (like sleep duration or stress level) to make sure they are physiologically valid before calculating anything. ## Use Cases ### Client is suspiciously sore and wants to lift heavy A personal trainer runs your metrics through calculate_readiness_score. The resulting low score, combined with the get_soreness_impact_analysis pointing to tight hamstrings, tells them immediately that a weighted mobility session is required instead of squats. ### Athlete wants to adjust training after poor sleep An athlete enters their metrics. The MCP calculates a low score and advises an 'Active Rest' day. They use validate_recovery_metrics first, confirming the input data was accepted as legitimate. ### Coach needs to adjust plan for injury prevention A coach runs get_soreness_impact_analysis on a client who is struggling with knee pain. The tool isolates the quadriceps and hip flexors, allowing the coach to immediately modify the next week's routine to target those specific weaknesses. ### Starting a new fitness tracking regimen A user connects their sleep tracker data. They run validate_recovery_metrics to ensure the input stream is reliable, then use calculate_readiness_score for a trustworthy baseline recommendation. ## Benefits - Avoid overtraining or undertraining by using calculate_readiness_score. It provides a concrete score and advises on the right workout intensity (Heavy to Active Rest) for today. - Get precise feedback on performance limits using get_soreness_impact_analysis. This tool doesn't just say you're sore; it names the specific muscle group holding back your progress. - Ensure data integrity before making decisions. validate_recovery_metrics checks all inputs to make sure your recovery numbers are within valid physiological bounds, keeping your plan accurate. - Stop wasting workouts on suboptimal days. By combining sleep duration and soreness metrics into a single score, you guarantee that effort matches actual recovery capacity. - Reduce coaching time spent reviewing logs. Instead of manually comparing sleep data with DOMS reports, the MCP synthesizes everything instantly for actionable advice. ## How It Works The bottom line is, it moves your workout planning from guesswork to quantifiable data. 1. Input your personal metrics into the MCP, including hours slept, perceived soreness ratings, stress levels, and motivation scores. 2. The system processes these physiological and psychological markers to calculate a comprehensive readiness score and estimate when you'll be fully recovered. 3. You receive an immediate recommendation on training intensity (Heavy to Active Rest) or specific muscle groups that require attention. ## Frequently Asked Questions **How does the Recovery Readiness Score MCP use my soreness data?** The system uses get_soreness_impact_analysis to identify which specific muscle groups are limiting your performance. This tells you exactly where to focus recovery efforts. **Can I trust the scores from calculate_readiness_score?** Yes, but first run validate_recovery_metrics. It confirms that all input metrics—like sleep hours or stress levels—are within valid physiological ranges before generating a score. **Does this MCP help with overall fitness planning?** It helps manage the daily load. By providing an intensity recommendation, it keeps you from overtraining and ensures your effort matches your body's current recovery capacity. **What if my input data is wrong for calculate_readiness_score?** You should run validate_recovery_metrics first. It acts as a guardrail, flagging any metrics that fall outside normal human physiological bounds, preventing inaccurate scoring. **Which tools do I need to check my progress?** Start with calculate_readiness_score for the daily recommendation. Then use get_soreness_impact_analysis periodically to monitor specific muscle group recovery over time.