WorkoutX Exercise API
Server Details
Exercise API MCP: 1,900+ exercises with video, workout generator, supplements, dev tools.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- furkanuruk/workoutx-mcp
- GitHub Stars
- 0
- Server Listing
- WorkoutX MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 23 tools
Most tools target a clearly distinct resource+action: catalog search vs single fetch vs media refresh vs filters vs v1 mapping are all separable, and the calculators and generators are unique. The main soft spots are find_similar_exercises vs find_exercise_alternatives (similarity ranking vs substitution) and a documentation cluster (get_endpoint_reference, get_code_example, diagnose_request, generate_types) where an agent may hesitate over which to call first, though the descriptions do draw the lines.
Every one of the 23 tools follows the same snake_case verb_noun convention (check_, diagnose_, estimate_, export_, find_, generate_, get_, list_, map_, search_), with nouns that consistently name the resource. No camelCase or bare-noun outliers; the prefix reliably signals the action class.
23 tools is on the heavy side, but the server genuinely spans several sub-domains (exercise catalog, media, filters, supplements, body scan, program/workout generation, calculators, and API diagnostics), so most tools earn their place. The docs/diagnostics group of six tools is the one area that could be consolidated without losing capability.
The surface covers the full read lifecycle for the catalog: discovery (search, filters, trending), retrieval (get_exercise, media refresh, similar/alternatives), export, v1 migration, plus generation, supplements, calculators, and account/quota diagnostics. No obvious dead ends remain; body scan is intentionally docs-only because photos go straight to that API.
Available Tools
23 toolscheck_api_keyCheck API keyARead-onlyInspect
Confirm the configured API key works and show the plan and remaining quota. Uses one request.
Inputs: no named parameters.
diagnose_requestDiagnose a requestARead-onlyInspect
Paste a failing WorkoutX request (curl, URL or "GET /v2/...") and optionally the status and response body: explains what is wrong (wrong host, key in the URL, missing header, unknown or repeated parameter, invalid value, v1 id, plan gate, rate limit, quota, expired media link) and how to fix it. Only reads the text; never sends the request. Uses one request.
Inputs: request (required), status, response.
estimate_body_fatEstimate body fat without a photoARead-onlyInspect
Body fat estimates from published equations using tape measurements: Relative Fat Mass (height, waist), U.S. Navy (adds neck, plus hip for women) and Deurenberg (adds weight, age). For adults and general wellness only, not medical advice. No photo needed.
Inputs: gender (required), waist_cm (required), height_cm (required), age, +3 more.
estimate_caloriesEstimate caloriesBRead-onlyInspect
Calories burned for an exercise from its MET value, body weight and duration.
Inputs: id (required), minutes, weightKg.
export_exercise_seedExport exercises for seedingARead-onlyInspect
Exercise ids, names, muscles and equipment without media, as JSON or CSV, to seed your own database or fixtures. Does not use the distinct-exercise media limit. Page with offset; plan caps per call apply (Free 10, Starter 100, others 200).
Inputs: lang, limit, model, fields, +6 more.
find_exercise_alternativesFind exercise alternativesARead-onlyInspect
Ranked swaps that train the same muscles, e.g. when equipment is missing. Optionally require or exclude equipment.
Inputs: id (required), lang, limit, model, +2 more.
find_similar_exercisesFind similar exercisesARead-onlyInspect
Exercises most similar to the given one (same pattern, muscles and equipment), ranked by score.
Inputs: id (required), lang, limit, model.
generate_programGenerate a training programCRead-onlyInspect
A multi-week program with periodisation, deloads and weekly volume targets. Needs the Scale plan.
Inputs: goal, lang, seed, level, +7 more.
generate_typesGenerate model typesARead-onlyInspect
Ready-to-paste TypeScript, Swift (Codable), Kotlin (kotlinx.serialization) or Dart models for v2 responses, generated from the OpenAPI spec. Uses one request.
Inputs: language (required), models.
generate_workoutGenerate a workoutBRead-onlyInspect
One complete session built from movement patterns: warm-up, main work with sets/reps/rest, cool-down and swap suggestions. Needs the Growth plan or higher.
Inputs: goal, lang, seed, level, +8 more.
get_body_scan_integrationGet Body Scan integration guideARead-onlyInspect
How to add the WorkoutX Body Scan API to an app: endpoint, auth, fields, response shape, errors and ready-to-paste code. It returns docs only and never takes a photo: your app sends photos straight to the Body Scan API.
Inputs: language.
get_body_scan_sample_responseGet a Body Scan sample responseARead-onlyInspect
A realistic sample of any Body Scan API response, so you can build and test the UI without spending scan credits. Covers success, an unreliable photo, errors and progress results.
Inputs: scenario.
get_code_exampleGet a code exampleARead-onlyInspect
A working snippet for a platform and task: listing and paging exercises, playing the looping MP4 and refreshing its signed link, the workout generator, error and rate-limit handling, or a backend proxy that keeps your key off the device. Uses one request.
Inputs: topic (required), platform (required).
get_endpoint_referenceGet endpoint referenceARead-onlyInspect
Parameters, response shape, errors and a curl example for any v2 endpoint, straight from the OpenAPI spec. Call with no endpoint to list them all. Uses one request.
Inputs: endpoint.
get_exerciseGet an exerciseARead-onlyInspect
One exercise by v2 id: instructions, tips, muscles, equipment, sets/reps guidance, calories and signed media links.
Inputs: id (required), lang.
get_exercise_mediaGet exercise mediaARead-onlyInspect
Fresh signed MP4 and thumbnail links for one exercise (links expire; call again rather than storing them).
Inputs: id (required).
get_supplement_stackBuild a supplement stackARead-onlyInspect
A recommended stack for a goal with dosages and timing. Needs the Scale plan.
Inputs: goal (required), level.
get_trending_exercisesGet trending exercisesARead-onlyInspect
The exercises and filters (body parts, muscles, equipment, categories) requested most across WorkoutX apps in the last 30 days. Anonymised: only values at least 3 different accounts asked for, filters as shares. Good for deciding what to feature in an app. Uses one request.
Inputs: lang, limit.
get_usage_statsGet usage statisticsARead-onlyInspect
Your account's API usage: requests, success rate, response times (avg and p95), errors by status code, top endpoints, daily counts, live quota, rate limit and media-limit usage. Use it to answer "why am I getting 429s?" or "when will my quota run out?". Uses one request.
Inputs: days.
list_exercise_filtersList exercise filtersARead-onlyInspect
Every valid value (with counts) for body parts, target muscles, equipment, categories and muscles. Call this before search_exercises when unsure of a value.
Inputs: lang.
map_v1_exerciseMap a v1 exercise id to v2ARead-onlyInspect
Find the v2 exercise for an old v1 id (e.g. "0025"), with the match quality: exact, equivalent, alternative, closest or none.
Inputs: v1Id (required), lang.
search_exercisesSearch exercisesARead-onlyInspect
Search 1,900+ exercises. Filters are optional and case-insensitive; combining two or more filters needs the Starter plan or higher. Results include instructions, tips, muscles, equipment, difficulty, calories and signed MP4/thumbnail links.
Inputs: lang, name, force, limit, +11 more.
search_supplementsSearch supplementsARead-onlyInspect
Supplements with evidence ratings, dosage and timing. Filter by category, goal, timing, evidence or free text. Needs the Growth plan or higher.
Inputs: goal, limit, offset, search, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
1,413+ HD exercise videos with muscles and instructions, plus workout and program generation.
Unofficial Wger MCP — wraps wger Workout Manager REST API (free, no auth for read)
Fitness MCP: AI personal trainer, workouts, injury exercise swaps, race pacing. Pay-per-call x402.
Fitness MCP for coaches and gyms: build workouts and read clients' training from live Superset data.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server providing access to 1,324 exercises in 10 languages with animation GIFs, offering tools to list facets, search exercises, get exercise details, and build workouts.-
- AlicenseAqualityDmaintenanceAn MCP server that provides access to detailed exercise-to-muscle mapping data for over 320 exercises and 65 muscles. It enables users to analyze workout coverage, find exercise alternatives based on muscle overlap, and search for specific exercise activation data.636 npm4MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server specialized in managing and querying gym exercises through a centralized database. It enables users to search for workouts by name or muscle group and retrieve detailed information including sets, repetitions, and rest intervals.1-
- AlicenseNot gradedqualityCmaintenanceEnables creating workout plans, tracking progress, suggesting exercises, and calculating training volume through natural language, compliant with MCP protocol.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.