Skip to main content
Glama

WorkoutX MCP Server — Exercise & Fitness API for AI Agents

npm MCP license

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.

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

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

MIT licensed.

Available Tools

20 tools
check_api_keyCheck API keyA
Read-only
Inspect

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

Inputs: no named parameters.

diagnose_requestDiagnose a requestA
Read-only
Inspect

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 caloriesB
Read-only
Inspect

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

Inputs: id (required), minutes, weightKg.

export_exercise_seedExport exercises for seedingA
Read-only
Inspect

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 alternativesA
Read-only
Inspect

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 exercisesA
Read-only
Inspect

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 programC
Read-only
Inspect

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 typesA
Read-only
Inspect

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 workoutB
Read-only
Inspect

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 exampleA
Read-only
Inspect

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 referenceA
Read-only
Inspect

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 exerciseA
Read-only
Inspect

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 mediaA
Read-only
Inspect

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 stackA
Read-only
Inspect

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

Inputs: goal (required), level.

get_usage_statsGet usage statisticsA
Read-only
Inspect

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 filtersA
Read-only
Inspect

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 v2A
Read-only
Inspect

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 exercisesA
Read-only
Inspect

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 supplementsA
Read-only
Inspect

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

    A3.7/5.0

    Scored across 20 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      19
      25 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to access and manage fitness programs, exercise catalog, workout resources, activity metrics, journaled plan edits, and change tracking through authenticated tools.
      51 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      74
      40 npm
      1
      AGPL 3.0