WorkoutX Exercise API

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

• Connection: Computer or cloud
• Transport: stdio, Streamable HTTP
• Category: Clinics & health
• You need to fill in: WORKOUTX_API_KEY, X-WorkoutX-Key

Install

Pick the AI app you use, then copy the settings.

You need

• Runs in the cloudNothing to install; it connects over the internet
• npmNode.js installed (for the npx command)

Which app do you use?

{
  "mcpServers": {
    "workoutx": {
      "command": "npx",
      "args": [
        "-y",
        "workoutx-mcp"
      ],
      "env": {
        "WORKOUTX_API_KEY": "your-value"
      }
    }
  }
}

claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header 'X-WorkoutX-Key: your-value'

claude mcp add workoutx --env WORKOUTX_API_KEY=your-value -- npx -y workoutx-mcp

{
  "mcpServers": {
    "workoutx": {
      "url": "https://api.workoutxapp.com/mcp",
      "headers": {
        "X-WorkoutX-Key": "your-value"
      }
    }
  }
}

{
  "mcpServers": {
    "workoutx": {
      "command": "npx",
      "args": [
        "-y",
        "workoutx-mcp"
      ],
      "env": {
        "WORKOUTX_API_KEY": "your-value"
      }
    }
  }
}

{
  "servers": {
    "workoutx": {
      "type": "http",
      "url": "https://api.workoutxapp.com/mcp",
      "headers": {
        "X-WorkoutX-Key": "your-value"
      }
    }
  }
}

{
  "servers": {
    "workoutx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "workoutx-mcp"
      ],
      "env": {
        "WORKOUTX_API_KEY": "your-value"
      }
    }
  }
}

Your choice stays on this device in a cookie; no account needed.

Values you fill in

• WORKOUTX_API_KEY secret required env
  WorkoutX API key (free at https://workoutxapp.com/dashboard.html)
• X-WorkoutX-Key secret required HTTP header
  WorkoutX API key (free at https://workoutxapp.com/dashboard.html)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

• list_exercise_filters

  Every valid value (with counts) for body parts, target muscles, equipment, categories and muscles. Call this before search_exercises when unsure of a value.

• search_exercises

  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.

• get_exercise

  One exercise by v2 id: instructions, tips, muscles, equipment, sets/reps guidance, calories and signed media links.

• get_exercise_media

  Fresh signed MP4 and thumbnail links for one exercise (links expire; call again rather than storing them).

• find_exercise_alternatives

  Ranked swaps that train the same muscles, e.g. when equipment is missing. Optionally require or exclude equipment.

• find_similar_exercises

  Exercises most similar to the given one (same pattern, muscles and equipment), ranked by score.

• estimate_calories

  Calories burned for an exercise from its MET value, body weight and duration.

• map_v1_exercise

  Find the v2 exercise for an old v1 id (e.g. "0025"), with the match quality: exact, equivalent, alternative, closest or none.

• generate_workout

  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.

• generate_program

  A multi-week program with periodisation, deloads and weekly volume targets. Needs the Scale plan.

• search_supplements

  Supplements with evidence ratings, dosage and timing. Filter by category, goal, timing, evidence or free text. Needs the Growth plan or higher.

• get_supplement_stack

  A recommended stack for a goal with dosages and timing. Needs the Scale plan.

• export_exercise_seed

  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).

• get_usage_stats

  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.

• get_trending_exercises

  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.

• get_endpoint_reference

  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.

• generate_types

  Ready-to-paste TypeScript, Swift (Codable), Kotlin (kotlinx.serialization) or Dart models for v2 responses, generated from the OpenAPI spec. Uses one request.

• get_code_example

  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.

• get_body_scan_integration

  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.

• get_body_scan_sample_response

  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.

• estimate_body_fat

  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.

• diagnose_request

  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) an

• check_api_key

  Confirm the configured API key works and show the plan and remaining quota. Uses one request.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

• ✓ Pass

  Maker matches the repo

  The registry name was verified with the GitHub account furkanuruk, which owns the repo

• … Not checked yet

  Still maintained

  We have not read this repo from GitHub yet

• … Not checked yet

  Has a licence

  We have not read this repo from GitHub yet

• ✓ Pass

  Endpoint responds

  Responded in 355 ms (HTTP 200)

• – Not applicable

  Sign-in with OAuth

  No sign-in needed

• ✓ Pass

  No hidden instructions in tool descriptions

  Read 23 tool descriptions and found no hidden instructions to the AI

Compared with others in Clinics & healthi

• More stars than 0% of the other 1023 servers in this category
• Published to the registry more recently than 71% of the other 1023 servers in this category
• Basic checks equal to or better than 100% of the other 1023 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

README from the maker

claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header "X-WorkoutX-Key: wx_your_key"

{

{

npm install && npm run build