# ExerciseDB MCP MCP > ExerciseDB provides access to a database of 1300+ exercises. Use this MCP to search and filter workouts by body part, target muscle, required equipment, or exercise name. You get detailed instructions, animated GIFs, and specific recommendations for building custom routines instantly. ## Overview - **Category:** learning-training - **Price:** Free - **Tags:** fitness-tracking, workout-routines, muscle-groups, exercise-instruction, health-data ## Description Need to design a workout but aren't sure if the client can manage those lunges with a kettlebell? This MCP lets you explore an entire library of exercises using just your natural conversation. Instead of flipping through manuals or searching multiple sites, you ask your agent what works for specific constraints—like finding upper back movements that only require body weight. It breaks down the complexity of fitness planning into simple queries. You can narrow down options by muscle group (quads, biceps, etc.), check what equipment is required (dumbbells, resistance bands), or even see all available exercises targeting your core. Everything pulls together in one place. This kind of deep data access makes it a key resource for any professional using the Vinkius catalog. ## Tools ### get_all_exercises Retrieves names, body parts, muscle targets, required equipment, GIF URLs, and instructions for all exercises. ### get_body_part_list Provides a list of valid human body parts recognized by the database. ### get_equipment_list Lists all available equipment types used in the exercise catalog (e.g., barbell, cable). ### get_exercise_by_id Gets detailed information for one specific exercise using its unique ID. ### get_exercises_by_body_part Returns a list of exercises filtered by the primary body area they work, like 'back' or 'shoulders'. ### get_exercises_by_equipment Finds exercises that require a specific piece of equipment, such as dumbbells or resistance bands. ### get_exercises_by_name Searches for matching exercises based on a name query like 'squats' or 'crunches'. ### get_exercises_by_target Filters the database to show only exercises that specifically target muscles like biceps, quads, or glutes. ### get_target_list Provides a list of all specific muscle groups and areas targeted by the exercises. ## Prompt Examples **Prompt:** ``` Show me exercises for chest with dumbbells. ``` **Response:** ``` Found 15+ chest exercises with dumbbells including: Dumbbell Bench Press, Dumbbell Fly, Incline Dumbbell Press, Decline Dumbbell Fly. Each includes step-by-step instructions and animated GIF. ``` **Prompt:** ``` What exercises target the abs? ``` **Response:** ``` Found 50+ exercises targeting abs including: Crunches, Plank, Bicycle Crunches, Russian Twist, Leg Raises, Mountain Climbers. Each with instructions, body part, equipment needed and GIF. ``` **Prompt:** ``` Show me exercises I can do with just body weight. ``` **Response:** ``` Found 100+ body weight exercises including: Push-ups, Pull-ups, Squats, Lunges, Plank, Burpees, Dips. No equipment needed — perfect for home workouts. ``` ## Capabilities ### Search by specific body part Find lists of workouts and exercises designed specifically for areas like the back, chest, or quads. ### Filter by required muscle group Target routines to build strength in precise muscles, such as glutes, triceps, or lats. ### Limit exercises by equipment Discover workouts that only use items you have on hand, like just a single pair of dumbbells or zero equipment. ### Get details for one exercise Retrieve full instructions, muscle targets, and animated GIFs for a single, known exercise by its ID. ## Use Cases ### Designing a post-injury routine A physical therapist needs to find exercises for a patient recovering from a shoulder injury. They use the agent to run `get_exercises_by_body_part` for 'shoulders' and then filter that result using `get_target_list` to ensure it only targets 'delts', while also checking if the required equipment is minimal. ### Creating a home-workout plan A personal trainer needs to build an entire full-body routine for a client who has zero gear. They ask the agent, and it uses `get_exercises_by_equipment` with 'body weight' to populate every single movement category. ### Checking workout legality An app developer needs to confirm if a certain exercise is possible with a limited set of gear. They use the agent to check `get_exercises_by_name` for 'kettlebell swings' and verify that 'kettlebell' is listed as required equipment. ### Finding specific muscle builders A fitness enthusiast wants to maximize their triceps workout. They query the agent using `get_exercises_by_target` for 'triceps', getting a list of options, and then use `get_all_exercises` to check out all available variations. ## Benefits - Pinpoint specific movements using `get_exercises_by_target`. Instead of guessing which exercises hit the lats, you ask for them and get a clean list with instructions. - Build routines around limitations. If a client only has body weight at home, use `get_exercises_by_equipment` to pull hundreds of options instantly. - Avoid guesswork when planning splits. Use `get_exercises_by_body_part` to gather all exercises for your client's weak areas, like the upper back or hamstrings. - Get comprehensive data retrieval by running multiple filters in one go. The agent combines criteria (e.g., 'chest' AND 'dumbbells') far faster than manual searching. - If you know exactly what move they need but not its ID, `get_exercises_by_name` finds it immediately, giving you full details like muscle targets and GIFs. ## How It Works The bottom line is you get instant, structured data on fitness movements without leaving your chat window. 1. Subscribe to the ExerciseDB MCP and input your unique API key. 2. Ask your agent a detailed question, like 'Show me chest exercises using dumbbells for beginners.' 3. The system queries the database and returns full details, including step-by-step instructions and GIF URLs. ## Frequently Asked Questions **How do I find exercises targeting my glutes using get_exercises_by_target?** You ask the agent directly for 'glute' exercises. The system uses `get_exercises_by_target` to pull a list, and then can refine that by equipment or body part. **Do I need to use get_body_part_list first?** No. While you *can* use `get_body_part_list` to see valid inputs, it's easier just to ask the agent for exercises by body part; it handles the lookup automatically. **What if I only know the exercise name?** Use `get_exercises_by_name`. It searches the entire database and returns full details, letting you check equipment and muscle groups even if you only remember the basic move name. **How do I get all available tools in the ExerciseDB MCP?** The agent can run a series of calls to `get_target_list` and `get_equipment_list`. This gives you reference lists for every muscle group and piece of gear tracked. **How do I retrieve all exercises if the total count exceeds a page limit using get_all_exercises?** You must manage large result sets with pagination. Pass the 'limit' and 'offset' parameters to `get_all_exercises`. This fetches data in controlled chunks, preventing timeouts or hitting API rate limits. **What is the best way to get full details for a single exercise using get_exercise_by_id?** Pass the specific ID you want into `get_exercise_by_id`. This returns all comprehensive data points—name, body parts, target muscles, instructions, and GIF URLs—for that one entry immediately. **Before searching for equipment, how do I confirm a valid type using get_equipment_list?** Always run `get_equipment_list` first. It provides the current, validated list of usable equipment types. This ensures your searches with `get_exercises_by_equipment` always work correctly. **If I need a full list of body parts to use in my search, should I call get_body_part_list?** Yes, calling `get_body_part_list` provides the master list of valid body parts. Use these values when you run targeted searches with `get_exercises_by_body_part`. **How do I get an ExerciseDB API key?** Sign up on [**RapidAPI**](https://rapidapi.com/justin-w-fns/api/exercisedb) and subscribe to the ExerciseDB API. Free tier includes 10 requests/day. Paid plans offer more requests. **What body parts are available?** The database includes: back, chest, shoulders, upper arms, lower arms, upper legs, lower legs, neck, waist and cardio. Use get_body_part_list to see the complete list. **Does the API include exercise instructions?** Yes! Each exercise includes step-by-step instructions (numbered list) and an animated GIF URL showing the proper form and movement.