# WorkoutX Exercise API (remote · api.workoutxapp.com)

Exercise API MCP: 1,900+ exercises with video, workout generator, supplements, dev tools.

- Trust score: 74/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `api.workoutxapp.com`: 74/100 (this document), [markdown](https://verifymcp.io/servers/furkanuruk-workoutx/api.md), [page](https://verifymcp.io/servers/furkanuruk-workoutx/api)
- npm · `workoutx-mcp`: 38/100, [markdown](https://verifymcp.io/servers/furkanuruk-workoutx/workoutx-mcp.md), [page](https://verifymcp.io/servers/furkanuruk-workoutx/workoutx-mcp)

## Channel facts

- Endpoint: `https://api.workoutxapp.com/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `2.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 11/100
  - TLS not yet verified: we couldn't open a connection to check the certificate.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS not yet verified: we couldn't read the response headers to check for it.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but we couldn't connect to verify it.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the WorkoutX Exercise API MCP server?

WorkoutX Exercise API is a hosted endpoint at https://api.workoutxapp.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http furkanuruk-workoutx 'https://api.workoutxapp.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "furkanuruk-workoutx": {
      "url": "https://api.workoutxapp.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "furkanuruk-workoutx": {
      "type": "http",
      "url": "https://api.workoutxapp.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.furkanuruk-workoutx]
url = "https://api.workoutxapp.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "furkanuruk-workoutx": {
      "type": "remote",
      "url": "https://api.workoutxapp.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add furkanuruk-workoutx --url 'https://api.workoutxapp.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  furkanuruk-workoutx:
    url: "https://api.workoutxapp.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "furkanuruk-workoutx": {
      "Transport": "http",
      "Url": "https://api.workoutxapp.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add furkanuruk-workoutx -t streamable-http -u 'https://api.workoutxapp.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "furkanuruk-workoutx": {
      "type": "http",
      "url": "https://api.workoutxapp.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 74, 0)

- [security regression] Endpoint reachability: reachable → unreachable
- [security regression] Authorization: partial → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] TLS certificate: pass → unverified
- [security regression] HSTS header: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-11-03 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-01 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 72, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-10-29 (score 71)

First indexed and scored.

## MCP tools (20)

### `list_exercise_filters` (~59 tokens)

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.

Input parameters:

- `lang` (string): Language for names, instructions and tips (default en)

### `search_exercises` (~285 tokens)

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.

Input parameters:

- `bodyPart` (string): e.g. Chest, Back, Upper Legs, Waist
- `category` (string)
- `difficulty` (string)
- `equipment` (string): e.g. Barbell, Dumbbell, Body Weight, Cable
- `fields` (array): Only these top-level fields, e.g. ["name","target","equipment"]; id is always included. Smaller answers, fewer tokens.
- `force` (string)
- `includeMedia` (boolean): false: no video links and no use of the distinct-exercise media limit (default true)
- `lang` (string): Language for names, instructions and tips (default en)
- `limit` (integer): Max results (default 10, plan caps apply)
- `mechanic` (string)
- `model` (string): Animation model
- `muscle` (string): Matches primary or secondary muscles
- `name` (string): Partial name match, e.g. "bench press"
- `offset` (integer)
- `target` (string): Primary target, e.g. Pectorals, Glutes, Lats

### `get_exercise` (~73 tokens)

Get an exercise

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

Input parameters:

- `id` (string, required): v2 exercise id, e.g. "ex_GE5XEP"
- `lang` (string): Language for names, instructions and tips (default en)

### `get_exercise_media` (~52 tokens)

Get exercise media

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

Input parameters:

- `id` (string, required): v2 exercise id, e.g. "ex_GE5XEP"

### `find_exercise_alternatives` (~127 tokens)

Find exercise alternatives

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

Input parameters:

- `equipment` (string): Only alternatives using this equipment (comma-separated)
- `excludeEquipment` (string): Leave out this equipment (comma-separated)
- `id` (string, required): v2 exercise id, e.g. "ex_GE5XEP"
- `lang` (string): Language for names, instructions and tips (default en)
- `limit` (integer): Max results (default 10, plan caps apply)
- `model` (string)

### `find_similar_exercises` (~92 tokens)

Find similar exercises

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

Input parameters:

- `id` (string, required): v2 exercise id, e.g. "ex_GE5XEP"
- `lang` (string): Language for names, instructions and tips (default en)
- `limit` (integer): Max results (default 10, plan caps apply)
- `model` (string)

### `estimate_calories` (~75 tokens)

Estimate calories

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

Input parameters:

- `id` (string, required): v2 exercise id, e.g. "ex_GE5XEP"
- `minutes` (number): Duration in minutes (default 10)
- `weightKg` (number): Body weight in kg (default 70)

### `map_v1_exercise` (~82 tokens)

Map a v1 exercise id to v2

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

Input parameters:

- `lang` (string): Language for names, instructions and tips (default en)
- `v1Id` (string, required): v1 exercise id, e.g. "0025"

### `generate_workout` (~194 tokens)

Generate a 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.

Input parameters:

- `avoidJoints` (array): Joints to spare; exercises that load them are left out
- `bodyFocus` (array): Muscles or body parts to emphasise
- `duration` (integer): Minutes (default 45)
- `equipment` (array): Available equipment, e.g. ["dumbbell","bench"]; empty = gym
- `exclude` (array): Exercise ids to leave out
- `format` (string)
- `goal` (string)
- `lang` (string): Language for names, instructions and tips (default en)
- `level` (string)
- `model` (string): Animation model
- `seed` (string): Same seed + same inputs = same workout
- `split` (string)

### `generate_program` (~147 tokens)

Generate a training program

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

Input parameters:

- `avoidJoints` (array): Joints to spare; exercises that load them are left out
- `daysPerWeek` (integer): Default 3
- `duration` (integer): Minutes per session (default 60)
- `equipment` (array)
- `format` (string)
- `goal` (string)
- `lang` (string): Language for names, instructions and tips (default en)
- `level` (string)
- `model` (string): Animation model
- `seed` (string)
- `weeks` (integer): Default 4

### `search_supplements` (~127 tokens)

Search supplements

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

Input parameters:

- `category` (string): e.g. protein, creatine, pre-workout
- `evidence` (string): e.g. strong, moderate
- `goal` (string)
- `limit` (integer): Max results (default 200, plan caps apply)
- `offset` (integer)
- `search` (string)
- `timing` (string): e.g. pre-workout, post-workout, morning

### `get_supplement_stack` (~42 tokens)

Build a supplement stack

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

Input parameters:

- `goal` (string, required)
- `level` (string)

### `export_exercise_seed` (~177 tokens)

Export exercises for seeding

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

Input parameters:

- `bodyPart` (string)
- `category` (string)
- `equipment` (string)
- `fields` (array): Default: name, model, bodyPart, target, equipment, difficulty, category
- `format` (string): Default json
- `lang` (string): Language for names, instructions and tips (default en)
- `limit` (integer): Max results (default 200, plan caps apply)
- `model` (string): Animation model
- `offset` (integer)
- `target` (string)

### `get_usage_stats` (~93 tokens)

Get usage statistics

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.

Input parameters:

- `days` (integer): Window in days (default 30, max 60)

### `get_trending_exercises` (~105 tokens)

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.

Input parameters:

- `lang` (string): Language for names, instructions and tips (default en)
- `limit` (integer): Max results (default 20, plan caps apply)

### `get_endpoint_reference` (~74 tokens)

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.

Input parameters:

- `endpoint` (string): e.g. "/v2/exercises", "exercises/{id}/alternatives" or a full URL

### `generate_types` (~111 tokens)

Generate model types

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

Input parameters:

- `language` (string, required)
- `models` (array): Default: ExerciseV2, ExercisePageV2, WorkoutV2, ProgramV2. Others: MediaLinksV2, MuscleV2, RankedPageV2, CaloriesV2, SupplementV2, AccountUsageV2, TrendingV2…

### `get_code_example` (~74 tokens)

Get a 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.

Input parameters:

- `platform` (string, required)
- `topic` (string, required)

### `diagnose_request` (~140 tokens)

Diagnose a 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) and how to fix it. Only reads the text; never sends the request. Uses one request.

Input parameters:

- `request` (string, required): curl command, URL or "GET /v2/..." line, with headers if you have them
- `response` (string): Response body, if any
- `status` (integer)

### `check_api_key` (~27 tokens)

Check API key

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

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/furkanuruk-workoutx/api#diagnostics

## Score history

- 2026-11-05: 74
- 2026-11-04: 74
- 2026-11-03: 74
- 2026-11-02: 73
- 2026-11-01: 73
- 2026-10-31: 72
- 2026-10-30: 72
- 2026-10-29: 71

## Common questions

### What is the WorkoutX Exercise API MCP server?

WorkoutX Exercise API is an MCP server listed in the public MCP registry as io.github.furkanuruk/workoutx. Exercise API MCP: 1,900+ exercises with video, workout generator, supplements, dev tools. This page covers its hosted endpoint (https://api.workoutxapp.com/mcp).

### Is the WorkoutX Exercise API MCP server safe to use?

WorkoutX Exercise API scores 74 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the WorkoutX Exercise API MCP server expose?

WorkoutX Exercise API exposes 20 tools: list_exercise_filters, search_exercises, get_exercise, get_exercise_media, find_exercise_alternatives, and 15 more. Their descriptions and schemas cost roughly 2,156 tokens of context every time the server is loaded.

### Does the WorkoutX Exercise API MCP server require authentication?

Its publisher declares that WorkoutX Exercise API requires credentials, so you will need to authorise it in your MCP client. We have not been able to confirm that against the live endpoint.

### Is the WorkoutX Exercise API MCP server still maintained?

WorkoutX Exercise API is still listed in the MCP registry, though our most recent checks did not reach this channel. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.workoutxapp.com/mcp
- Authorisation metadata: https://api.workoutxapp.com/.well-known/oauth-protected-resource/mcp
- Repository: https://github.com/furkanuruk/workoutx-mcp
- Website: https://workoutxapp.com/mcp.html
- Changelog RSS feed: https://verifymcp.io/servers/furkanuruk-workoutx/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/furkanuruk-workoutx/api.json
- HTML version of this page: https://verifymcp.io/servers/furkanuruk-workoutx/api
