WorkoutX Exercise API

WorkoutX MCP サーバー — AI エージェント向けエクササイズ＆フィットネス API

Claude Code、Cursor、ChatGPT、Grok、VS Code、Claude Desktop から WorkoutX Exercise API を利用できます。720p MP4 アニメーション（男性・女性モデル）付きの1,900種類以上のエクササイズ、ワークアウトと複数週間のプログラム生成機能、エビデンス評価付きサプリメントデータベース、フィットネスアプリ構築用の開発者ツール（型付きモデル、コード例、リクエストのデバッグ、利用統計）を提供します。

「WorkoutX の45分間のダンベル胸部セッションを使って、アプリにワークアウト画面を追加してください。」 「エクササイズとワークアウト用の Swift モデルを生成してください。」 「昨日から429エラーが発生しているのはなぜですか？」

• ホスト型エンドポイント： https://api.workoutxapp.com/mcp（Streamable HTTP）— 実行するものはありません
• 認証： X-WorkoutX-Key ヘッダー（または Authorization: Bearer）に WorkoutX API キーを指定します
• 無料プラン： 500リクエスト、クレジットカード不要 — キーを取得
• 各ツール呼び出しは API リクエスト1件としてカウントされ、REST API と同じプラン制限が適用されます
• ドキュメントとセットアップガイド：workoutxapp.com/mcp.html

ツール

開発者ツール

ツール	機能
get_endpoint_reference	任意の v2 エンドポイントのパラメーター、レスポンス形式、エラー、curl の例
generate_types	TypeScript、Swift（Codable）、Kotlin（kotlinx.serialization）、Dart のモデル
get_code_example	React Native、Swift、Flutter、Next.js、Node、Python 向けのコードスニペット：一覧、リンク更新を伴う動画再生、ワークアウト、エラー処理、バックエンドプロキシ
diagnose_request	失敗したリクエスト（ステータスと本文も含む）を貼り付けると、原因と解決策を提示します。リクエストは送信されません

エクササイズデータ、ワークアウト、サプリメント

ツール	機能
get_usage_stats	リクエスト数、成功率、p95 レイテンシ、ステータス別エラー、上位エンドポイント、クォータ、メディア制限
export_exercise_seed	メディアを含まないエクササイズ ID、名前、筋肉、器具を JSON または CSV で出力します（メディア制限は消費しません）
get_trending_exercises	WorkoutX アプリ全体でリクエスト数の多いエクササイズとフィルターを匿名化して表示します
search_exercises	カタログを検索・絞り込みます。回答を小さくするには fields と includeMedia を指定します
get_exercise	1つのエクササイズの説明、ヒント、筋肉、カロリー、メディアリンク
get_exercise_media	新しい署名付き MP4 およびサムネイルのリンク
list_exercise_filters	有効な身体部位、ターゲット、器具、カテゴリ、筋肉
find_exercise_alternatives	同じ筋肉を鍛える代替エクササイズを、指定した器具の有無に応じて検索します
find_similar_exercises	類似度順に並べた、最も類似するエクササイズ
estimate_calories	体重と時間からカロリーを推定します
map_v1_exercise	v1 エクササイズ ID → v2 エクササイズ
generate_workout	ウォームアップ、セット・回数・休憩、クールダウンを含む1回分の完全なセッション（Growth+）
generate_program	期分けとデロードを含む複数週間のプログラム（Scale）
search_supplements	エビデンス、用量、摂取タイミングを含むサプリメント（Growth+）
get_supplement_stack	目標に応じた推奨サプリメントの組み合わせ（Scale）
check_api_key	プランと残りクォータ

すべてのツールは読み取り専用で、API キーが必要です。呼び出しはそれぞれ API リクエスト1件としてカウントされます。

接続

Claude Code

claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header "X-WorkoutX-Key: wx_your_key"

Cursor（~/.cursor/mcp.json）および VS Code

{
  "mcpServers": {
    "workoutx": {
      "url": "https://api.workoutxapp.com/mcp",
      "headers": { "X-WorkoutX-Key": "wx_your_key" }
    }
  }
}

Claude Desktop（ワンクリック）

workoutx.mcpb をダウンロードし（リリースページからも入手できます）、開いてください。Claude Desktop が拡張機能をインストールし、API キーを尋ねます。

Claude Desktop（手動設定）およびその他の stdio 専用クライアント

このパッケージは、stdio とホストされたエンドポイントを橋渡しします。

{
  "mcpServers": {
    "workoutx": {
      "command": "npx",
      "args": ["-y", "workoutx-mcp"],
      "env": { "WORKOUTX_API_KEY": "wx_your_key" }
    }
  }
}

変数	必須	デフォルト
WORKOUTX_API_KEY	はい	—
WORKOUTX_MCP_URL	いいえ	https://api.workoutxapp.com/mcp

開発

npm install && npm run build
npm run smoke                                            # against production
WORKOUTX_MCP_URL=http://localhost:3000/mcp npm run smoke # against a local API

リンク

• ウェブサイト：workoutxapp.com · MCP ガイド：workoutxapp.com/mcp.html
• REST API ドキュメント：workoutxapp.com/docs.html
• SDK：JavaScript · Python · Swift · Flutter
• サポート：[email protected]

MIT ライセンス。