Challenges · iAM360 MCP docs

Challenges

readget_challenges

All of the user's active, paused, completed and abandoned challenges, with their daily task lists and ids.

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

readget_challenges

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "get_challenges",    "arguments": {}  }}

Result

{  "challenges": [    {      "id": "28b1efff-4c4a-4c3a-8eb9-da51c6d902d8",      "name": "7-Day Hydration Challenge",      "description": "Daily hydration and a short walk for 7 days.",      "duration": 7,      "startDate": "2026-10-14",      "timezone": "America/Phoenix",      "status": "active",      "templateId": null,      "createdAt": "2026-10-14T15:02:44.120+00:00",      "updatedAt": "2026-10-14T15:02:44.120+00:00",      "tasks": [        {          "id": "4f9a3a43-28e9-4208-a919-fc778f293644",          "challengeId": "28b1efff-4c4a-4c3a-8eb9-da51c6d902d8",          "label": "Drink 3 liters of water",          "sortOrder": 0        },        {          "id": "7c3e9d14-5b2a-4f86-9e01-3a8d2c6b7f45",          "challengeId": "28b1efff-4c4a-4c3a-8eb9-da51c6d902d8",          "label": "Walk 10 minutes",          "sortOrder": 1        }      ]    }  ]}

Parameters

None. Call it with an empty object: {}.

Result

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

Active challenges come first, then paused, completed and abandoned. Today's progress on active ones is in get_overview.

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.