Workouts

Search exercises

readsearch_exercises

Matches one or more exercise-name queries against the iAM360 catalog and the user's custom exercises. Returns accessible exercise ids, names, muscle groups and equipment.

Access: Reads data and changes nothing.
Annotations: readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: falsetitle: Search the exercise catalog
Time limit: 25 seconds, then the call stops with an error.

readsearch_exercises

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "search_exercises",    "arguments": {      "queries": ["bench press", "pull-ups"]    }  }}

Result

{  "results": [    {      "query": "bench press",      "candidates": [        {          "exerciseId": "8b410f27-6136-466a-81af-d61a8692ec26",          "name": "<stored_data>Bench Press</stored_data>",          "muscleGroup": "<stored_data>Chest</stored_data>",          "equipment": "<stored_data>Barbell</stored_data>",          "isCustom": false        }      ]    },    {      "query": "pull-ups",      "candidates": [        {          "exerciseId": "b48c14d2-26f9-46b2-b45e-2364150642e8",          "name": "<stored_data>Pull-Up</stored_data>",          "muscleGroup": "<stored_data>Back</stored_data>",          "equipment": "<stored_data>Bodyweight</stored_data>",          "isCustom": false        }      ]    }  ]}

Parameters

queriesarray of stringsRequired
1 to 10 items

Result

One text item holding a JSON object, as in the example.

Candidates are ranked by how closely the name matches. Pick the one the user meant; nothing is chosen for you.

Errors

Every tool returns isError with a message when its arguments don't match the schema, a limit is reached, the person turned the agent off, or iAM360 has a problem. See Errors and limits.