WorkoutX MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WorkoutX MCP Server find dumbbell chest exercises and build me a 45-minute workout"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WorkoutX MCP Server — Exercise & Fitness API for AI Agents
Give Claude Code, Cursor, ChatGPT, Grok, VS Code and Claude Desktop the WorkoutX Exercise API: 1,900+ exercises with 720p MP4 animations (male and female models), a workout and multi-week program generator, an evidence-rated supplement database, and developer tools for building fitness apps: typed models, code examples, request debugging and usage stats.
"Add a workout screen to the app using a 45-minute dumbbell chest session from WorkoutX." "Generate Swift models for exercises and workouts." "Why are we getting 429s since yesterday?"
Hosted endpoint:
https://api.workoutxapp.com/mcp(Streamable HTTP) — nothing to runAuth: your WorkoutX API key in the
X-WorkoutX-Keyheader (orAuthorization: Bearer)Free plan: 500 requests, no credit card — get a key
Every tool call counts as one API request, with the same plan limits as the REST API
Docs and setup guide: workoutxapp.com/mcp.html
Tools
Developer tools
Tool | What it does |
| Parameters, response shape, errors and a curl example for any v2 endpoint |
| TypeScript, Swift (Codable), Kotlin (kotlinx.serialization) or Dart models |
| Snippets for React Native, Swift, Flutter, Next.js, Node and Python: lists, video playback with link refresh, workouts, error handling, a backend proxy |
| Paste a failing request (and status/body): the cause and the fix. Never sends it |
Exercise data, workouts and supplements
Tool | What it does |
| Your requests, success rate, p95 latency, errors by status, top endpoints, quota and media limits |
| Exercise ids, names, muscles and equipment as JSON or CSV, without media (no media limit used) |
| Most requested exercises and filters across WorkoutX apps, anonymised |
| Search and filter the catalog; |
| One exercise: instructions, tips, muscles, calories, media links |
| Fresh signed MP4 and thumbnail links |
| Valid body parts, targets, equipment, categories and muscles |
| Swaps for the same muscles, with or without given equipment |
| Most similar exercises, ranked |
| Calories from body weight and duration |
| v1 exercise id → v2 exercise |
| One full session with warm-up, sets/reps/rest and cool-down (Growth+) |
| Multi-week program with periodisation and deloads (Scale) |
| Supplements with evidence, dosage and timing (Growth+) |
| Recommended stack for a goal (Scale) |
| Plan and remaining quota |
All tools are read-only and need an API key; each call counts as one API request.
Related MCP server: GeniusFitness MCP
Connect
Claude Code
claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header "X-WorkoutX-Key: wx_your_key"Cursor (~/.cursor/mcp.json) and VS Code
{
"mcpServers": {
"workoutx": {
"url": "https://api.workoutxapp.com/mcp",
"headers": { "X-WorkoutX-Key": "wx_your_key" }
}
}
}Claude Desktop (one click)
Download workoutx.mcpb (also on the releases page) and open it. Claude Desktop installs the extension and asks for your API key.
Claude Desktop (manual) and other stdio-only clients
This package bridges stdio to the hosted endpoint:
{
"mcpServers": {
"workoutx": {
"command": "npx",
"args": ["-y", "workoutx-mcp"],
"env": { "WORKOUTX_API_KEY": "wx_your_key" }
}
}
}Variable | Required | Default |
| yes | — |
| no |
|
Development
npm install && npm run build
npm run smoke # against production
WORKOUTX_MCP_URL=http://localhost:3000/mcp npm run smoke # against a local APILinks
Website: workoutxapp.com · MCP guide: workoutxapp.com/mcp.html
REST API docs: workoutxapp.com/docs.html
SDKs: JavaScript · Python · Swift · Flutter
Support: support@workoutxapp.com
MIT licensed.
Available Tools
20 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_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_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…
TDQS
Scored across 20 tools
Most tools target clearly distinct actions (search vs get vs media vs generate vs diagnose). The one real risk is find_exercise_alternatives vs find_similar_exercises, which sound nearly identical, though the descriptions differentiate them (equipment-swap ranking vs pattern/muscle/equipment similarity). Descriptions resolve most would-be confusion.
Names follow a strong verb_noun snake_case pattern throughout (list_exercise_filters, get_exercise, search_exercises, generate_workout, diagnose_request, check_api_key). No camelCase or mixed-verb drift; 'generate_types' and 'list_exercise_filters' are minor but readable variations.
20 tools is slightly heavy but each maps to a distinct capability across search, media, generation, supplements, developer tooling and account diagnostics. It sits just above the comfortable 3-15 band but no tool feels redundant.
The surface covers discovery (filters, search, trending), retrieval (get, media), derivation (alternatives, similar, calories, v1 mapping), content generation, supplements, export and rich dev/ops tooling. Minor gaps exist (no favorites/profile or retrieval of previously generated workouts/programs), but agents can work around them.
Maintenance
Related MCP Connectors
Create, personalize and deliver branded workouts and programs from any AI assistant.
Your Garmin, Oura, WHOOP, Hevy and 35 more fitness apps, queryable from your own AI.
Log workouts and meals by telling your AI. 873 exercises, muscle diagrams, food lookup.
Access approved FITsociety clients, schedules, bookings and coaching data with AI assistants.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects AI agents to Iridium fitness data to query workout history, nutrition logs, and body measurements. It enables users to track exercise progress, training volume, and personalized trainer analysis through natural language.1925 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to access and manage fitness programs, exercise catalog, workout resources, activity metrics, journaled plan edits, and change tracking through authenticated tools.51 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to plan, build, and log calisthenics workouts in a user's own account, including searching exercises, managing custom workouts and plans, reading progress and coaching data, and logging completed sessions. Account mutations require explicit confirmation, and workouts can be displayed as interactive cards in the chat.MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to read, log, edit, and analyze workouts, routines, body weight, media, and personal records on a self-hosted openGym instance through its own HTTP API. Writes are scoped to requested changes with automatic backups and conflict detection, and tools are grouped into read, write, delete, and admin permission tiers.7440 npm1AGPL 3.0