Your Move Exercise Video API

What Your Move Exercise Video API MCP server does

Your Move Exercise Video API MCP server exposes the YMove Exercise Video API through Model Context Protocol. It gives connected clients access to a catalog of more than 1,413 HD exercise videos, along with exercise metadata and training-plan generation features.

The catalog can be searched by muscle group, equipment, difficulty, and exercise type. Individual exercise results include video URLs, instructions, and targeted muscles. The server also provides tools for creating structured workouts and multi-week training programs.

How it works

The server supports two connection patterns. A hosted MCP endpoint is available at https://exercise-api.ymove.app/mcp; clients that support remote MCP servers can connect to it by sending an API key in the X-API-Key header. This avoids installing the package locally.

For local use, clients start the ymove-exercise-mcp package through npx. The local process reads the API key from the YMOVE_API_KEY environment variable and communicates with the MCP client over the configured local transport.

Once connected, an agent can call search_exercises to narrow the catalog, use get_exercise for a specific movement, and inspect available categories with list_muscle_groups or list_exercise_types. Planning requests can use generate_workout or generate_program to return training structures with the supported workout fields.

Setup and configuration

A hosted setup requires an API key from the YMove Exercise Video API documentation or signup flow. For Claude, configure the HTTP endpoint with the X-API-Key header. Cursor uses the same endpoint and header in its MCP configuration.

A local Claude Desktop configuration starts the package with npx and passes the key as YMOVE_API_KEY. Claude Code can also register the local server with that environment variable. The repository documentation identifies Claude Desktop, Cursor, and Claude Code as supported setup targets.

The API documentation and signup links are provided through the YMove Exercise Video API website. The README also links to an npm SDK package, but the MCP setup uses the ymove-exercise-mcp package command.

Tools and capabilities

The Your Move Exercise Video API MCP server provides these tools:

• search_exercises: Filter the exercise catalog by muscle group, equipment, difficulty, and type.
• get_exercise: Retrieve exercise details, including video URLs, instructions, and muscles.
• generate_workout: Create a structured workout containing exercises, sets, reps, and rest times.
• generate_program: Create a multi-week training program with periodization.
• list_muscle_groups: Return muscle groups and their exercise counts.
• list_exercise_types: Return exercise types and their counts.

This makes the server suitable for agents that need to discover movements before assembling a workout, retrieve media and instructions for a selected exercise, or produce a longer training schedule from the available exercise data.

Limitations and notes

An API key is required for access. The hosted configuration sends that key as an HTTP header, while the local configuration stores it in YMOVE_API_KEY. The provided material does not specify additional authentication methods, rate limits, pricing, response schemas, or customization options for generated workouts and programs.

The available catalog size is described as more than 1,413 exercises and HD videos. Results and generated plans depend on the data and behavior of the YMove Exercise Video API; the MCP layer exposes the listed API capabilities rather than documenting separate fitness-planning rules.