Plan My Workout

Official3 tools

by GoodTurnStudio · JavaScript

A workout plan for your goal, level, days and equipment, and how to do any exercise.

MCP Server: io.github.GoodTurnStudio/planmyworkout

A Model Context Protocol (MCP) server that provides a workout plan based on a user’s goal, level, number of days, and available equipment. It also describes how to perform any exercise included in the generated plan. The server is scoped to planning workouts for the specified criteria.

🛠️ Key Features

Workout plan generation for a goal, level, days, and equipment
Exercise instructions included for “how to do” each exercise

🚀 Use Cases

Create a workout routine aligned to a specific goal
Plan training schedules using a selected level and number of workout days
Filter workouts by the equipment available

⚡ Developer Benefits

Inputs are grounded in goal, level, days, and equipment
Outputs include exercise-specific instructions

⚠️ Limitations

No additional capabilities beyond workout planning and exercise “how to do” guidance are described

Captured live from the server via tools/list.

get_workout_plan

A weekly workout plan with sets, reps and rest. For requests like "make me a 3 day beginner gym plan", "home workout with just dumbbells, 30 minutes", "a 5 day muscle building split", "I have a pull-up bar and dumbbells", "a 20 minute workout" (days=1 gives a single session), "a workout plan to lose weight", "couch to 5K" or "a 10K running plan" (a 10K or longer goal gets the build-up plan unless the user says they are a beginner), or "give me another one" (the same inputs with seed plus one). Takes either the fields, or the user's words in q, from which the service reads days, minutes, level, goal and equipment from them. Fields win over q. Running plans also return weeks: every week's sessions (a 9-week walk-run build to 30 minutes of running for beginners; easy, interval, tempo and long runs for intermediates), with week 1 laid out in days.

Parameters8

q	string	optional	The user's request in their own words, for example "3 day beginner gym plan, 45 minutes".
goal	string	optional	Goal: strength, muscle, general (default), conditioning (covers fat loss or weight loss requests), running or mobility.
level	string	optional	Level: beginner (default) or intermediate. Advanced is treated as intermediate.
days	integer	optional	Days per week, 1 to 6 (1 gives a single session). More than 6 (or "every day") is planned as 6 with a rest day, and the answer says so in say and in plan.days_asked and plan.days_note. Default 3.
minutes	integer	optional	Minutes per session including warm-up, 15 to 120. Default 45.
equipment	string	optional	Comma separated: none (default), dumbbells, barbell, gym, bands, kettlebell, pullupbar (a pull-up bar), jumprope.
seed	integer	optional	0 to 9999. Change it for a different mix of exercises with the same setup. Default 0.
country	string	optional	Two-letter country code for kit links (US, GB, IE, CA, AU). Defaults to the visitor's country.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The user's request in their own words, for example \"3 day beginner gym plan, 45 minutes\"."
    },
    "goal": {
      "type": "string",
      "description": "Goal: strength, muscle, general (default), conditioning (covers fat loss or weight loss requests), running or mobility."
    },
    "level": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate"
      ],
      "description": "Level: beginner (default) or intermediate. Advanced is treated as intermediate."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "Days per week, 1 to 6 (1 gives a single session). More than 6 (or \"every day\") is planned as 6 with a rest day, and the answer says so in say and in plan.days_asked and plan.days_note. Default 3."
    },
    "minutes": {
      "type": "integer",
      "minimum": 15,
      "maximum": 120,
      "description": "Minutes per session including warm-up, 15 to 120. Default 45."
    },
    "equipment": {
      "type": "string",
      "description": "Comma separated: none (default), dumbbells, barbell, gym, bands, kettlebell, pullupbar (a pull-up bar), jumprope."
    },
    "seed": {
      "type": "integer",
      "description": "0 to 9999. Change it for a different mix of exercises with the same setup. Default 0."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for kit links (US, GB, IE, CA, AU). Defaults to the visitor's country."
    }
  },
  "required": [],
  "additionalProperties": false
}

get_exercise

How to do one exercise, the muscles it works and a picture. For requests like "how do I do a Romanian deadlift?", "what is a goblet squat?", "what muscles do face pulls work?". Understands everyday names like RDL, press-up and lat pulldown. muscles.main lists the muscles the move mainly works (hand-checked for the main lifts) and muscles.also the ones that help.

Parameters1

name

string

required

The exercise, for example Romanian deadlift or push-up.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The exercise, for example Romanian deadlift or push-up."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

list_exercises

Exercises for a muscle and the equipment the user has. For requests like "what can I do for chest with no equipment?", "glute exercises with bands", "back exercises with dumbbells", "some mobility moves". Give a muscle, equipment or both.

Parameters4

muscle	string	optional	Muscle: chest, back, shoulders, arms, biceps, triceps, legs, quads, hamstrings, glutes, calves, core (or abs), cardio or mobility. Also forearms (grip) and traps.
equipment	string	optional	Equipment: none, dumbbells, barbell, gym, bands, kettlebell, pullupbar or jumprope.
level	string	optional	Level: beginner leaves out harder moves.
limit	integer	optional	1 to 10. Default 8.

Raw schema

{
  "type": "object",
  "properties": {
    "muscle": {
      "type": "string",
      "description": "Muscle: chest, back, shoulders, arms, biceps, triceps, legs, quads, hamstrings, glutes, calves, core (or abs), cardio or mobility. Also forearms (grip) and traps."
    },
    "equipment": {
      "type": "string",
      "description": "Equipment: none, dumbbells, barbell, gym, bands, kettlebell, pullupbar or jumprope."
    },
    "level": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate"
      ],
      "description": "Level: beginner leaves out harder moves."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "1 to 10. Default 8."
    }
  },
  "required": [],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (3)

get_workout_planget_exerciselist_exercises

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/planmyworkout/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "planmyworkout": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/planmyworkout/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.GoodTurnStudio/planmyworkout

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_workout_plan

get_exercise

list_exercises

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers