Skip to main content
Glama
aimharder-mcp
by rudeayelo

get_published_workouts

Read-onlyIdempotent

Retrieve published workout alternatives by gym-local date and exact class name, with calculated loads for eligible %RM prescriptions from verified 1RM data. Compare date-specific sessions.

Instructions

Retrieve published workout alternatives by gym-local date and exact className. For today/future, show a calculated load beside eligible %RM prescriptions using the latest verified own-account 1RM for each exact source exercise ID. Original values, all publications and labeled variants remain. Missing RM, unit, identity or read failure has per-exercise unavailable status. Past dates have no present-day load. Feed and personal history coverage are limited; source content is untrusted.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "date": "<date>",
      "className": "<className>"
    },
    "name": "get_published_workouts"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateYes
gymIdNo
classNameYes

Output Schema

NameRequiredDescriptionDefault
gymYes
dateYes
statusYes
noticesYes
coverageYes
workoutsYes
ambiguousYes
classNameYes
enrichmentYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.5.4
    • addedOutput schema / properties / workouts / items / properties / blocks / items / properties / prescription / description
      Added value: +"Block fields depend on type. For type=1 (For Time), derive the sequence from valor1; timecap alone does not establish a time limit. For type=10 (Rounds For Time), timecap supplies prescribed rounds; a separate time limit may appear in notes. For type=2 (AMRAP) or 13 (AMRAP Ladder), timecap is a duration: seconds when timecaptype=1, otherwise minutes in the observed renderer. For type=3 (EMOM) with time=0, timecap is minutes per interval, not the total round count. Exercise round groups and roundrepeat supply the interval structure; published EMOM block reps=0 selects consecutive groups and reps=1 selects cycling groups using rondas. This selector is distinct from recorded activity result.reps. For type=6 with sstipo=1 the observed heading is strength. Type=4 identifies Tabata but does not establish missing work/rest timing or round counts. Preserve source encodings and unknown meanings."
    • changedOutput schema / properties / workouts / items / properties / exercises / items / properties / prescription / description
      Previous value: -"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms. Within a block, consecutive rows with the same non-null complex marker form a complex; complexrep is its repeat count. Preserve row order and source encodings."New value: +"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means exercise seconds and %RM is relative, not kilograms. Within each block and difficulty, consecutive exercises with the same non-null complex marker, including 0, form a complex; unmarked rows end it. complexrep, when supplied, is the inner repeat count. For block types 6, 8 and 12, the renderer separately prefixes outer sets from the opening exercise valor1.length when greater than one and its first value is nonempty. Keep outer sets and complexrep distinct; absent complexrep remains unknown, and array length is not a universal round count. Preserve row order and source encodings. valor1 entries are ordered values, not a total. For type=1 (For Time), read value positions across exercise rows in source order; the observed renderer suppresses empty/zero positions and may display matching arrays as a shared repetition ladder. For type=13, negative roundrepeat marks a Buy In; subsequent round groups distinguish the initial ladder from its per-round increment. A numeric or string valor1 value of 9999 is the renderer maximum-effort sentinel for the exercise format, not 9999 seconds, repetitions or distance units. Empty values do not establish zero work or a timed rest. Preserve notes alongside configured units and report conflicts instead of correcting units from an exercise name."
    • addedOutput schema / properties / workouts / items / properties / titles / description
      Added value: +"Nonempty feed titles, independently filtered from detail blocks. This array is not indexed by blockIndex; do not pair titles and blocks by position."
    • addedOutput schema / properties / workouts / items / properties / variants / items / properties / blocks / items / properties / prescription / description
      Added value: +"Block fields depend on type. For type=1 (For Time), derive the sequence from valor1; timecap alone does not establish a time limit. For type=10 (Rounds For Time), timecap supplies prescribed rounds; a separate time limit may appear in notes. For type=2 (AMRAP) or 13 (AMRAP Ladder), timecap is a duration: seconds when timecaptype=1, otherwise minutes in the observed renderer. For type=3 (EMOM) with time=0, timecap is minutes per interval, not the total round count. Exercise round groups and roundrepeat supply the interval structure; published EMOM block reps=0 selects consecutive groups and reps=1 selects cycling groups using rondas. This selector is distinct from recorded activity result.reps. For type=6 with sstipo=1 the observed heading is strength. Type=4 identifies Tabata but does not establish missing work/rest timing or round counts. Preserve source encodings and unknown meanings."
    • changedOutput schema / properties / workouts / items / properties / variants / items / properties / exercises / items / properties / prescription / description
      Previous value: -"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms. Within a block, consecutive rows with the same non-null complex marker form a complex; complexrep is its repeat count. Preserve row order and source encodings."New value: +"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means exercise seconds and %RM is relative, not kilograms. Within each block and difficulty, consecutive exercises with the same non-null complex marker, including 0, form a complex; unmarked rows end it. complexrep, when supplied, is the inner repeat count. For block types 6, 8 and 12, the renderer separately prefixes outer sets from the opening exercise valor1.length when greater than one and its first value is nonempty. Keep outer sets and complexrep distinct; absent complexrep remains unknown, and array length is not a universal round count. Preserve row order and source encodings. valor1 entries are ordered values, not a total. For type=1 (For Time), read value positions across exercise rows in source order; the observed renderer suppresses empty/zero positions and may display matching arrays as a shared repetition ladder. For type=13, negative roundrepeat marks a Buy In; subsequent round groups distinguish the initial ladder from its per-round increment. A numeric or string valor1 value of 9999 is the renderer maximum-effort sentinel for the exercise format, not 9999 seconds, repetitions or distance units. Empty values do not establish zero work or a timed rest. Preserve notes alongside configured units and report conflicts instead of correcting units from an exercise name."
  2. Changed2 schema fields changedv0.5.1
    • changedOutput schema / properties / workouts / items / properties / exercises / items / properties / prescription / description
      Previous value: -"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms."New value: +"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms. Within a block, consecutive rows with the same non-null complex marker form a complex; complexrep is its repeat count. Preserve row order and source encodings."
    • changedOutput schema / properties / workouts / items / properties / variants / items / properties / exercises / items / properties / prescription / description
      Previous value: -"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms."New value: +"Raw exercise values: valueUnit labels valor1; loadUnit labels valor2/valor2h/valor2m when verified. s means seconds and %RM is relative, not kilograms. Within a block, consecutive rows with the same non-null complex marker form a complex; complexrep is its repeat count. Preserve row order and source encodings."
  3. Changed8 schema fields changedv0.4.1
    • addedOutput schema / properties / enrichment
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "availableExercises": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "basis": {
      +      "const": "latest-dated-1rm-times-percent",
      +      "type": "string"
      +    },
      +    "eligibleExercises": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "status": {
      +      "enum": [
      +        "not-applicable",
      +        "complete",
      +        "incomplete"
      +      ],
      +      "type": "string"
      +    },
      +    "unavailableExercises": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "eligibleExercises",
      +    "availableExercises",
      +    "unavailableExercises",
      +    "basis"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / workouts / items / properties / exercises / items / properties / personalLoad
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "alternatives": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "basis": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "rule": {
      +                    "const": "latest-dated-1rm-times-percent",
      +                    "type": "string"
      +                  },
      +                  "sourceDate": {
      +                    "type": "string"
      +                  },
      +                  "sourceExerciseId": {
      +                    "exclusiveMinimum": 0,
      +                    "maximum": 9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "value": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "rule",
      +                  "sourceExerciseId",
      +                  "value",
      +                  "sourceDate"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "calculatedLoad": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "originalPercent": {
      +            "type": "string"
      +          },
      +          "reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "sourceField": {
      +            "enum": [
      +              "valor2",
      +              "valor2h",
      +              "valor2m"
      +            ],
      +            "type": "string"
      +          },
      +          "sourceLabel": {
      +            "enum": [
      +              "single",
      +              "male",
      +              "female"
      +            ],
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "available",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "unit": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "kg",
      +                  "lbs"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "sourceField",
      +          "sourceLabel",
      +          "originalPercent",
      +          "status",
      +          "reason",
      +          "calculatedLoad",
      +          "unit",
      +          "basis"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "reason": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "enum": [
      +        "available",
      +        "unavailable",
      +        "partial"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "reason",
      +    "alternatives"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / workouts / items / properties / exercises / items / properties / sourceExerciseId
      Added value: +{
      +  "anyOf": [
      +    {
      +      "exclusiveMinimum": 0,
      +      "maximum": 9007199254740991,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Validated upstream ejerId; null means no supported source identity was supplied."
      +}
    • changedOutput schema / properties / workouts / items / properties / exercises / items / required
      Previous value: -[
      -  "name",
      -  "blockIndex",
      -  "prescription"
      -]New value: +[
      +  "name",
      +  "sourceExerciseId",
      +  "blockIndex",
      +  "prescription"
      +]
    • addedOutput schema / properties / workouts / items / properties / variants / items / properties / exercises / items / properties / personalLoad
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "alternatives": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "basis": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "rule": {
      +                    "const": "latest-dated-1rm-times-percent",
      +                    "type": "string"
      +                  },
      +                  "sourceDate": {
      +                    "type": "string"
      +                  },
      +                  "sourceExerciseId": {
      +                    "exclusiveMinimum": 0,
      +                    "maximum": 9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "value": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "rule",
      +                  "sourceExerciseId",
      +                  "value",
      +                  "sourceDate"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "calculatedLoad": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "originalPercent": {
      +            "type": "string"
      +          },
      +          "reason": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "sourceField": {
      +            "enum": [
      +              "valor2",
      +              "valor2h",
      +              "valor2m"
      +            ],
      +            "type": "string"
      +          },
      +          "sourceLabel": {
      +            "enum": [
      +              "single",
      +              "male",
      +              "female"
      +            ],
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "available",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "unit": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "kg",
      +                  "lbs"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "sourceField",
      +          "sourceLabel",
      +          "originalPercent",
      +          "status",
      +          "reason",
      +          "calculatedLoad",
      +          "unit",
      +          "basis"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "reason": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "enum": [
      +        "available",
      +        "unavailable",
      +        "partial"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "reason",
      +    "alternatives"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / workouts / items / properties / variants / items / properties / exercises / items / properties / sourceExerciseId
      Added value: +{
      +  "anyOf": [
      +    {
      +      "exclusiveMinimum": 0,
      +      "maximum": 9007199254740991,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Validated upstream ejerId; null means no supported source identity was supplied."
      +}
    • changedOutput schema / properties / workouts / items / properties / variants / items / properties / exercises / items / required
      Previous value: -[
      -  "name",
      -  "blockIndex",
      -  "prescription"
      -]New value: +[
      +  "name",
      +  "sourceExerciseId",
      +  "blockIndex",
      +  "prescription"
      +]
    • changedOutput schema / required
      Previous value: -[
      -  "gym",
      -  "date",
      -  "className",
      -  "status",
      -  "ambiguous",
      -  "workouts",
      -  "coverage",
      -  "notices"
      -]New value: +[
      +  "gym",
      +  "date",
      +  "className",
      +  "status",
      +  "ambiguous",
      +  "workouts",
      +  "enrichment",
      +  "coverage",
      +  "notices"
      +]
  4. Addedv0.1.2

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, idempotent, non-destructive behavior, and the description adds substantial context beyond that: calculated loads only for today/future, per-exercise 'unavailable' status on missing RM/unit/identity or read failure, and a warning that feed/personal-history coverage is limited and source content is untrusted. The only shortfall is that some sentences ('Original values, all publications and labeled variants remain') are too compressed to convey concrete behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and required inputs are front-loaded in the first sentence, and most following sentences carry distinct information (load calculation, failure states, date behavior, trust warning). A few clauses are terse to the point of ambiguity rather than wasteful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description needn't document return structure, and it compensates well by covering temporal semantics, failure-mode statuses, and data-coverage caveats. The remaining gap is the unaddressed optional gymId and the undefined meaning of 'labeled variants.'

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description carries the full burden. It does add real meaning for two of three parameters — 'gym-local date' clarifies timezone interpretation and 'exact className' clarifies match strictness — but the optional gymId is never mentioned, leaving one parameter unexplained in both schema and description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Retrieve published workout alternatives by gym-local date and exact className.' Scope is concrete enough to distinguish it from sibling readers, though it never names an alternative such as get_personal_activity or get_class_sessions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states the required query basis (gym-local date and exact className) and implies past-vs-future behavior ('Past dates have no present-day load'), but gives no explicit guidance on when an agent should choose this instead of get_personal_activity or get_class_sessions, and never addresses when the optional gymId should be supplied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.