Exercise MCP Server

WorkoutX MCP Server — Exercise & Fitness API for AI Agents

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

Exercise data, workouts and supplements

All tools are read-only and need an API key; each call counts as one API request.

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" }
    }
  }
}

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

Links

• Website: workoutxapp.com · MCP guide: workoutxapp.com/mcp.html
• REST API docs: workoutxapp.com/docs.html
• SDKs: JavaScript · Python · Swift · Flutter
• Support: support@workoutxapp.com

MIT licensed.