# YMovE Fitness MCP

> YMovE Fitness turns your AI agent into a certified personal trainer and nutritionist. Build complete health regimens—from calculating precise macro targets for a full day of meals to generating multi-week workout programs tailored to strength or weight loss goals.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** workout-generator, meal-planning, fitness-tracking, health-data, exercise-database, wellness-coaching

## Description

This MCP gives your AI client the data it needs to build entire fitness lifecycles, not just single routines. You can generate an accurate meal plan that hits specific calorie and macro counts, then immediately use those parameters to design a corresponding training regimen. Need to track a complex diet? Look up any food by its barcode or search for recipes based on keto or vegan constraints. The power comes when you combine these different tools; you're not just getting data points—you’re building an automated coaching system that spans multiple disciplines, all through one AI agent. If your workflow requires combining fitness planning with other services, Vinkius makes this possible by letting you chain YMovE Fitness with a billing MCP or a messaging MCP to build automations across platforms.

It's about moving beyond simple lookups and creating an actionable plan that guides the user week after week.

## Tools

### generate_meal_plan
Creates a full day of meals designed to meet a specific calorie total.

### generate_program
Develops multi-week training programs focused on goals like strength, weight loss, or muscle gain.

### generate_workout
Builds a custom workout routine for a single session based on today's needs.

### get_exercise_details
Pulls complete instructions and details for any specific exercise in the database.

### get_food_by_barcode
Looks up a food item's nutritional data using its UPC or EAN barcode number.

### get_food_details
Retrieves the full nutritional breakdown for any specific type of food.

### get_recipe_details
Provides all necessary ingredients and instructions for a full recipe.

### list_exercise_types
Returns a list of general exercise categories, like strength or cardio.

### list_muscle_groups
Lists all available muscle groups to help structure workouts correctly.

### search_exercises
Searches the database and returns a list of matching exercises by name or type.

### search_foods
Queries the food database to find nutritional values for general keywords.

### search_recipes
Searches available recipes based on diet constraints (like keto or vegan) and calorie limits.

## Prompt Examples

**Prompt:** 
```
Generate a 30-minute chest and triceps workout using only dumbbells.
```

**Response:** 
```
Here is your 30-minute dumbbell workout for chest and triceps. Exercises: 1. Dumbbell Bench Press (3 sets of 10-12), 2. Dumbbell Flys (3 sets of 12), 3. Overhead Triceps Extension (3 sets of 12-15), 4. Triceps Kickbacks (3 sets of 15). Shall I pull up the detailed instructions and video for any of these exercises?
```

**Prompt:** 
```
Create a 2500 calorie vegan meal plan for today.
```

**Response:** 
```
I've generated a 2500-calorie vegan meal plan for you. Breakfast: Tofu Scramble with Avocado Toast (650 kcal). Lunch: Quinoa and Black Bean Bowl (750 kcal). Dinner: Lentil Shepherd's Pie (850 kcal). Snack: Roasted Chickpeas (250 kcal). The total macros are 120g Protein, 310g Carbs, and 85g Fat. Would you like the recipe details for the Shepherd's Pie?
```

**Prompt:** 
```
What are the macros for a generic banana?
```

**Response:** 
```
Based on the YMovE nutrition database, a medium generic banana (118g) contains 105 calories. The macros are: 1.3g Protein, 27g Carbohydrates (including 3.1g of fiber and 14.4g of sugar), and 0.4g Fat.
```

## Capabilities

### Generate Meal Plans
Calculates full-day meal plans, hitting exact calorie targets for specific diets.

### Create Training Programs
Develops multi-week workout programs structured around major goals like hypertrophy or weight loss.

### Build Single Workouts
Generates complete, single-session workouts customized by muscle group and available equipment.

### Lookup Food Data
Retrieves precise nutritional breakdown for specific foods, either through searching or using a UPC/EAN barcode.

### Find Specific Recipes
Searches and details recipes based on diet restrictions (e.g., vegan) or maximum calorie limits.

## Use Cases

### Creating a Strength Block
A personal trainer needs to build a 6-week strength program. They ask the agent, which uses `generate_program`, then use `list_muscle_groups` and `search_exercises` repeatedly to ensure progressive overload across all necessary movements.

### Managing Vegan Client Meals
A client needs a 2000-calorie vegan diet. The agent uses `generate_meal_plan`, which relies on finding suitable options via `search_recipes` and verifying ingredients using `get_recipe_details`.

### Rapid Workout Adjustment
A client is feeling sore and needs a modified workout. The agent uses `generate_workout`, constrained by the available equipment, pulling detailed instructions via `get_exercise_details` for each movement.

## Benefits

- Stop switching between diet sheets and workout logs. You can generate a complete plan, from the `generate_meal_plan` to the corresponding routine, all in one prompt.
- Need to check a client's snack? Use `get_food_by_barcode` or `search_foods` to pull immediate, accurate macro data without leaving your chat window.
- Design long-term goals with confidence. The `generate_program` tool builds multi-week schedules that adapt to specific objectives like hypertrophy or weight loss.
- `list_muscle_groups` and `search_exercises` let you build highly customized workouts, ensuring every session hits the right areas using equipment constraints.
- The system handles diverse diets. Use `search_recipes` to find meal options based on vegan rules, then use `get_recipe_details` for the full shopping list.

## How It Works

The bottom line is you tell your AI client what goal you have, and the MCP executes all the necessary lookups and calculations to deliver a cohesive plan.

1. Subscribe to this MCP and enter your API key from the YMovE Dashboard.
2. Connect your preferred AI client (Claude, Cursor, etc.) to Vinkius via that single connection point.
3. Ask your agent to build a plan—for instance, 'Give me a 2500-calorie vegan meal plan and pair it with three days of workouts for my back.' The MCP handles the data flow across nutrition and exercise.

## Frequently Asked Questions

**Are the exercise videos permanent or temporary?**
The video and thumbnail URLs returned by the API are pre-signed links that expire after 48 hours. If you are developing an app, you should not cache these URLs; instead, refetch the exercise details when displaying them.

**Can I generate a full weekly workout program?**
Yes! Use the `generate_program` tool. You can specify your primary goal (like hypertrophy), the number of weeks, the equipment you have available, and how many days per week you plan to train. The agent will return a complete, day-by-day split.

**How does the meal plan generator work?**
The `generate_meal_plan` tool uses a mathematical algorithm to select balanced recipes from the database (breakfast, lunch, dinner, snacks) that collectively hit your precise target calories and follow specific constraints like vegan or paleo.

**If I run `get_food_by_barcode` with an invalid UPC/EAN, what happens?**
The tool returns a precise error message indicating the input failure. It won't crash; instead, you get specific feedback on why the barcode is rejected or if the product ID is missing.

**Before I generate an exercise routine, how do I find all available options using `list_muscle_groups`?**
Running `list_muscle_groups` provides a full list of every supported muscle group. This helps you ensure your subsequent calls to `generate_workout` are precise and effective.

**Should I use `search_foods` or `get_food_details` for nutrition info?**
Use `search_foods` first if you need to filter options by keyword or general category. Once you have the name of a specific food item, then run `get_food_details` for its full nutritional breakdown.

**Is my data secure when I use `get_recipe_details`?**
Yes, all interactions are protected by Vinkius' zero-trust proxy. Your API keys pass only in transit and never get stored or exposed to your AI client.

**How do I filter results when I use the `search_recipes` tool?**
You can narrow down recipes by setting specific dietary constraints or maximum calorie limits. This lets you quickly find options, whether for keto diets or low-calorie targets.