What it does
This MCP server and CLI wraps the YMove exercise API, which catalogues more than 1,400 exercises with video. Its six tools search exercises by free text, muscle group, exercise type, equipment and difficulty, retrieve one exercise with its video URLs, instructions and worked muscles, generate a structured workout with sets, reps and rest times, generate a periodized multi-week program, and list muscle groups and exercise types with their counts. Each tool returns the upstream JSON unchanged.
It suits a training app or an AI agent that needs to query this exercise catalogue or build workouts and programs from it. Search results include only exercises that have video.
Running it requires a YMove API key, set as YMOVE_API_KEY and sent with every request as an X-API-Key header. It can be run as an MCP server, as a CLI where each tool is a subcommand that takes one JSON argument string, or in Docker. Missing or wrongly typed arguments are rejected before any request is sent.
Limitations and requirements
Requires a YMove API key; calls made without it fail. The generate_workout tool requires the muscleGroup argument. Exercise video URLs are signed by the upstream service and expire after 48 hours. Upstream API errors are passed through as tool errors. Some REST API filters are not exposed: white-background or gym-video filters, video-tag filters, and include or exclude video-list switches.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/exercisedb
YMove exercise video API: search exercises, generate workouts and multi-week programs.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it