# Recovery Readiness Score MCP for AI Agents AI Agent Connect > Recovery Readiness Score evaluates your training readiness and optimal intensity based on sleep, soreness, stress, and motivation. It helps you decide whether to push for a personal record or take a recovery day. Instead of guessing how your body feels, you get a data-driven score that tells you exactly how much effort you can handle today without burning out. ## Overview - **Category:** analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_MLv6dozHeHcMAgbMTTBmmZeI6OfLWhkz0E47XOQZ/ai-agent-connect - **Tags:** training, recovery, fitness-tracking, biometrics, performance ## Description Imagine you're trying to figure out if you can hit a heavy squat session today. You might feel okay on the surface, but your legs are still heavy from a session two days ago. This Connector lets you feed your agent the specifics: how many hours you slept, your current stress levels, and exactly how much your muscles ache. The agent then processes that data to give you a clear intensity rating, like 'Active Rest' or 'Heavy.' It takes the guesswork out of your training block. You can even pinpoint which muscles are actually dragging you down so you can adjust your movements or skip specific exercises. It's a huge upgrade for anyone using the Vinkius catalog to manage their personal fitness or athlete performance because it turns raw numbers into actionable training plans. You stop wondering if you're overtraining and start knowing exactly where your limits are. It helps you stay consistent by making sure your training matches your body's actual capacity on any given day. It also keeps your data clean by checking if the numbers you're inputting actually make sense for a human being, ensuring your training plan stays accurate and safe. ## Tools ### calculate_readiness_score Get a specific training intensity rating from Heavy to Active Rest. This helps you plan your workout volume based on your current recovery state. ### validate_recovery_metrics Check if your reported sleep and stress numbers are within normal ranges. This ensures your training plan is based on realistic and accurate data. ### get_soreness_impact_analysis Find out which specific muscle groups are causing the most fatigue. This lets you skip certain exercises to avoid injury or overtraining. ## Prompt Examples **Prompt:** ``` I slept 6 hours and my chest is really sore. My stress is high. Can I still do a heavy push day? ``` **Response:** ``` Based on your metrics, your recovery score is currently low. Because of the high stress and significant chest soreness, your recommended training intensity for today is **Active Rest**. **Recommendation:** * Skip heavy bench presses or weighted dips. * Focus on mobility work or light cardio. * Aim for a session that keeps your heart rate low. ``` **Prompt:** ``` Check my metrics: sleep 8, stress 3, soreness 2. Are these realistic? ``` **Response:** ``` Yes, all provided metrics are within the valid physiological and psychological ranges. Your recovery markers look solid for a high-intensity session. ``` **Prompt:** ``` My legs are at a 9 for soreness and my back is at a 2. What should I focus on today? ``` **Response:** ``` Based on your soreness levels, here is the breakdown for your session: * **Primary Focus:** Avoid heavy lower body movements. * **Limiting Factor:** Your **Legs** are at a critical fatigue level (9/10). * **Target Areas:** You can safely focus on upper body movements, specifically your back, which shows much lower fatigue (2/10). **Recommendation:** Stick to a **Pull Day** or upper body focus. Skip any heavy squats, lunges, or deadlifts today to allow your legs to recover. ``` ## Capabilities ### Get training intensity ratings Receive a specific recommendation on how hard to train today based on your recovery. ### Identify muscle fatigue See exactly which muscle groups are limiting your performance and need more rest. ### Validate recovery data Check if your input metrics fall within normal physiological and psychological ranges. ### Predict recovery time Get an estimate of when your body will be fully recovered for your next heavy session. ### Analyze soreness impact Determine how specific muscle soreness affects your overall training capacity. ## Use Cases ### Deciding on a heavy push day A bodybuilder wants to know if they can hit a heavy chest day after a stressful work week. They ask their agent to run calculate_readiness_score to see if their stress and sleep levels allow for it. ### Managing marathon mileage A marathon runner needs to decide if today is a day for a long run or a light recovery jog. They use get_soreness_impact_analysis to see if their legs are too fatigued for high mileage. ### Coaching a team of athletes A strength coach checks the readiness of five athletes at once. They use the agent to identify which ones need a rest day to avoid overtraining. ### Tracking personal fitness progress A fitness enthusiast wants to stay consistent without burning out. They use the Connector to ensure their daily training matches their body's actual capacity. ## Benefits - Stop guessing your daily limits by using calculate_readiness_score to get a clear intensity rating. - Avoid injury by using get_soreness_impact_analysis to see which muscles need more rest. - Keep your training data accurate by using validate_recovery_metrics to catch unrealistic inputs. - Stay consistent with your goals by matching your workout effort to your actual physiological state. - Identify specific recovery needs for different muscle groups instead of just resting the whole body. ## How It Works The bottom line is you get a data-backed training plan instead of guessing how much to push yourself. 1. Input your current metrics like sleep duration, stress levels, and muscle soreness. 2. The Connector analyzes these inputs against physiological bounds and previous training loads. 3. You get a readiness score and a specific recommendation for your training intensity. ## Frequently Asked Questions **How does Recovery Readiness Score help my training?** It turns your daily biometrics into a clear training plan. Instead of guessing, you get a specific intensity rating that tells you whether to push hard, go easy, or take a rest day. **Can I use Recovery Readiness Score to avoid overtraining?** Yes, that is one of its primary uses. By analyzing your stress and muscle soreness, it helps you identify when your body needs a break before you hit a wall. **Who is Recovery Readiness Score best for?** It is ideal for athletes, strength coaches, and fitness enthusiasts who want to use data to optimize their performance and stay consistent with their goals. **How do I know if my sleep data is accurate with Recovery Readiness Score?** The Connector includes a validation step to check if your reported metrics fall within normal physiological ranges, ensuring your training advice stays accurate. **What kind of intensity does Recovery Readiness Score suggest?** It provides a range of intensities, from 'Heavy' sessions for when you're fully recovered to 'Active Rest' for days when your body needs a lighter load. **Can Recovery Readiness Score help me manage a busy athlete's schedule?** Absolutely. Coaches can use it to quickly see which athletes are recovered enough for heavy loads and who needs a deload, helping to manage team volume effectively. **How is my training intensity determined?** The intensity is determined by analyzing your sleep quality, muscle soreness (DOMS), stress levels, and motivation. If high soreness or recent heavy sessions are detected via `calculate_readiness_score`, the system may recommend a lighter session like 'Light' or 'Active Rest'. **Can I check which muscle groups are preventing me from training hard?** Yes, you can use the `get_soreness_impact_analysis` tool. By providing your current DOMS levels, it will identify 'critical groups' that are currently limiting your overall readiness score. **What should I do if my metrics are invalid?** You can use `validate_recovery_metrics` to check your inputs. It will return a list of specific errors if any value (like stress or motivation) is outside the required 0-10 range.