Recommend catalog training plans
recommend_training_plansRank existing NexRex catalog training plans for an athlete. Read-only and rule-based: matches each plan's distance, goal, length, weekly volume, level and days per week against the athlete's recent training, race prediction and primary race, and holds back every plan when injury or recovery signals say not to push. Returns candidates with reason_codes, reasons and gaps, missing_inputs that would sharpen the match, health_hold, and no_good_match when no catalog plan fits (create_training_plan drafts a custom plan).
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": {
"athlete_id": "<athlete_id>"
},
"name": "recommend_training_plans"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | The athlete's aim; omit to infer it from their goal. | |
| top_k | No | Candidates to return, 1-10. | |
| distance | No | Target distance: full (marathon), half (half marathon), hyrox, start (beginner) or none (base); spellings such as 'Half Marathon' or 42k work. Omit to use the athlete's primary race. | |
| race_date | No | A calendar date, YYYY-MM-DD. | |
| athlete_id | Yes | The athlete's user id: get_current_user's athlete_id for the connected account, or an id from get_coach_athletes or find_athlete. | |
| target_time | No | Goal finish time, H:MM:SS or MM:SS; time_target goals use it. | |
| days_per_week | No | Days per week the athlete can train, 1-7. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| status | No | ||
| message | No | ||
| privacy | No | Present when the athlete's settings withhold data. | |
| warnings | No | ||
| data_gaps | No | ||
| next_step | No | What can be done next, for example after a failure. | |
| athlete_id | No | ||
| candidates | No | ||
| health_hold | No | ||
| next_cursor | No | Reads the next page; null on the last page. | |
| reason_code | No | ||
| total_weeks | No | ||
| catalog_size | No | ||
| user_content | No | Fields in this result that people wrote. | |
| no_good_match | No | ||
| missing_inputs | No | Inputs a good match still needs from the athlete. | |
| weeks_returned | No | ||
| athlete_summary | No | ||
| truncated_fields | No | Lists cut to fit one response: rows returned and total. | |
| generated_content | No | Fields in this result that NexRex's AI wrote. | |
| health_reason_codes | No | ||
| session_definitions | No | Sessions that several rows of this result share by session_ref. | |
| content_block_fields | No | Column names of every content_blocks row, nested blocks rows included. |