# WorkoutX Exercise API

> WorkoutX Exercise API is a freemium MCP server for health and science. Exercise database with video, workout generators and supplements for fitness apps. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://workoutxapp.com/mcp.html
- **Repository:** https://github.com/furkanuruk/workoutx-mcp
- **MCP Registry name:** io.github.furkanuruk/workoutx
- **Categories:** health and science, developer tools
- **Listing updated:** 2026-11-14

## About

WorkoutX runs a hosted MCP server in front of its exercise API, so an assistant can pull real exercise data while it writes or answers. The catalogue has 1,900 or more exercises with 720p MP4 demonstrations, male and female models, alternatives, similar-exercise ranking and calorie estimates.

It doubles as a developer helper. Tools return endpoint references, typed models for TypeScript, Swift, Kotlin or Dart, code examples for React Native, Swift, Flutter, Next.js, Node and Python, and request diagnosis for failures such as 429 errors. Your own usage stats and quota are exposed too.

A WorkoutX API key is required, sent in a header, and every tool call counts as one API request. The free plan includes 500 requests with no card. The workout generator and supplement search need the Growth plan or higher, and program generation and supplement stacks need Scale. Plan prices are not shown here.

## Features

- **Exercise catalogue:** Search 1,900+ exercises with instructions, muscles and 720p video links.
- **Workout generator:** Builds a full session with warm-up, sets, reps, rest and cool-down.
- **Program generator:** Creates multi-week plans with periodisation and deloads.
- **Supplement data:** Evidence-rated supplements with dosage and timing.
- **Typed models and snippets:** Generates Swift, Kotlin, Dart or TypeScript models and platform code.
- **Request diagnosis:** Explains why a failing API request fails without sending it.
- **Usage stats:** Reports requests, latency, errors and remaining quota.

## Good for

- Build a React Native screen that lists exercises with videos
- Give an AI coach real exercise tools
- Suggest home alternatives to barbell squats
- Seed an app database with exercise names and muscles
- Work out why requests return 429

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.workoutxapp.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "workoutx": {
      "serverUrl": "https://api.workoutxapp.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_endpoint_reference`: Parameters, response shape, errors and a curl example for a v2 endpoint
- `generate_types`: Generates TypeScript, Swift, Kotlin or Dart models
- `get_code_example`: Code snippets for several platforms
- `diagnose_request`: Explains the cause and fix for a failing request
- `get_usage_stats`: Requests, success rate, latency, errors and quota
- `export_exercise_seed`: Exports exercise ids, names, muscles and equipment as JSON or CSV
- `get_trending_exercises`: Most requested exercises and filters, anonymised
- `search_exercises`: Searches and filters the catalogue
- `get_exercise`: Returns one exercise with instructions, tips and media links
- `get_exercise_media`: Returns signed MP4 and thumbnail links
- `list_exercise_filters`: Lists valid body parts, targets, equipment and categories
- `find_exercise_alternatives`: Finds swaps for the same muscles
- `find_similar_exercises`: Ranks the most similar exercises
- `estimate_calories`: Estimates calories from body weight and duration
- `map_v1_exercise`: Maps a v1 exercise id to v2
- `generate_workout`: Builds one full session
- `generate_program`: Builds a multi-week program
- `search_supplements`: Searches supplements with evidence, dosage and timing
- `get_supplement_stack`: Recommends a supplement stack for a goal
- `check_api_key`: Shows plan and remaining quota

## FAQ

### Do I need an API key?

Yes. Get a free key from the WorkoutX dashboard.

### What does the free plan include?

500 requests with no credit card.

### Does every tool call cost a request?

Yes, each call counts as one API request.

### Which tools need a higher plan?

Workout generation and supplement search need Growth+, program generation and supplement stacks need Scale.

### Is it read-only?

Yes, all tools are read-only.

### Is WorkoutX Exercise API free?

WorkoutX Exercise API has a free plan, with paid plans for more usage or features.

### How do I add WorkoutX Exercise API to Claude Code?

Run this command in your terminal: claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp

### What are the best alternatives to WorkoutX Exercise API?

The closest alternatives to WorkoutX Exercise API are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.

---
Source: https://ai-powered.com/mcp/workoutx-exercise-api
