WorkoutX Exercise API

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 run
• Auth: your WorkoutX API key in the X-WorkoutX-Key header (or Authorization: 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
get_endpoint_reference	Parameters, response shape, errors and a curl example for any v2 endpoint
generate_types	TypeScript, Swift (Codable), Kotlin (kotlinx.serialization) or Dart models
get_code_example	Snippets for React Native, Swift, Flutter, Next.js, Node and Python: lists, video playback with link refresh, workouts, error handling, a backend proxy
diagnose_request	Paste a failing request (and status/body): the cause and the fix. Never sends it

Exercise data, workouts and supplements

Tool	What it does
get_usage_stats	Your requests, success rate, p95 latency, errors by status, top endpoints, quota and media limits
export_exercise_seed	Exercise ids, names, muscles and equipment as JSON or CSV, without media (no media limit used)
get_trending_exercises	Most requested exercises and filters across WorkoutX apps, anonymised
search_exercises	Search and filter the catalog; fields and includeMedia for smaller answers
get_exercise	One exercise: instructions, tips, muscles, calories, media links
get_exercise_media	Fresh signed MP4 and thumbnail links
list_exercise_filters	Valid body parts, targets, equipment, categories and muscles
find_exercise_alternatives	Swaps for the same muscles, with or without given equipment
find_similar_exercises	Most similar exercises, ranked
estimate_calories	Calories from body weight and duration
map_v1_exercise	v1 exercise id → v2 exercise
generate_workout	One full session with warm-up, sets/reps/rest and cool-down (Growth+)
generate_program	Multi-week program with periodisation and deloads (Scale)
search_supplements	Supplements with evidence, dosage and timing (Growth+)
get_supplement_stack	Recommended stack for a goal (Scale)
check_api_key	Plan and remaining quota

All tools are read-only and need an API key; each call counts as one API request.

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
WORKOUTX_API_KEY	yes	—
WORKOUTX_MCP_URL	no	https://api.workoutxapp.com/mcp

Development

npm install && npm run build
npm run smoke                                            # against production
WORKOUTX_MCP_URL=http://localhost:3000/mcp npm run smoke # against a local API

Links

• Website: workoutxapp.com · MCP guide: workoutxapp.com/mcp.html
• REST API docs: workoutxapp.com/docs.html
• SDKs: JavaScript · Python · Swift · Flutter
• Support: [email protected]

MIT licensed.