Skip to content
MCP server

WorkoutX Exercise API

Exercise database with video, workout generators and supplements for fitness apps

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
2.1.0
Listing updated
2 days ago

About WorkoutX Exercise API

WorkoutX Exercise API is a freemium MCP server for health and science. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.workoutxapp.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "workoutx": {
      "url": "https://api.workoutxapp.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • WORKOUTX_API_KEYWorkoutX API key (free at https://workoutxapp.com/dashboard.html)Required

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Free plan with 500 requests; paid Growth and Scale plans, prices not shown

Prices change. Check workoutxapp.com before you buy.

WorkoutX Exercise API 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 to WorkoutX Exercise API

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools