MCP connector

Kracey MCP Tools Reference

The connector has 19 tools. None of them changes anything: each one reads your own data or runs a calculation. Your assistant only sees the tools your scopes allow. How to connect is on the connector overview.

Your training

Needs intervals.icu connected to your Kracey account.

Kracey connection status

get_status

What this Kracey connection can see for the signed-in athlete: whether training data is connected, which devices it comes from, whether they have a coach plan, and which kinds of data were shared. Call it first when unsure what is available.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

List training sessions

list_sessions

The athlete's recorded training sessions, newest first: date, sport, duration, distance, pace and climb. Training load and heart rate are included only when the athlete shared heart and recovery data, and are null otherwise. Covers up to the last 90 days. Use session_id with get_session for one session in full.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

One session in full

get_session

One recorded session in full: its summary, minutes in each pace zone, and each lap or interval with its time, distance and pace. Heart rate (per lap and minutes in each zone) and the athlete's effort ratings are included only when the athlete shared heart and recovery data, and are null otherwise. Takes a session_id from list_sessions.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Training volume and trends

get_progress

How much the athlete has trained and how it is changing: weekly minutes, distance and session count for the last 12 weeks, the split by sport, and the last seven days against the athlete's recent weekly rate. Training load, minutes per heart rate zone, the easy share and polarization are included only when the athlete shared heart and recovery data, and are null otherwise.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Best running efforts

get_pace_curve

The athlete's best running time at each standard distance over the last year, from 400 m to the marathon, taken from their own recorded runs. A distance they have not covered in one effort is left out.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Race time predictions

get_race_predictions

Predicted 5K, 10K and half marathon times from the athlete's own best recent running effort, and the HYROX finish time that running fitness points to in Open and Pro, with the split between running, stations and Roxzone.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Your HYROX races

The results saved on your account.

Saved HYROX results

get_hyrox_results

The athlete's own HYROX races saved in Kracey, newest first: finish time, the eight run splits, the eight station splits, Roxzone time, and how much the last four runs slowed against the first four. `race` is the position in this list and is what compare_hyrox_races takes.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Compare two HYROX races

compare_hyrox_races

Sets one of the athlete's saved HYROX races against another and shows where the time moved: running and each station, in seconds, with the change in finish time. Uses the `race` numbers from get_hyrox_results. By default the most recent against the one before it.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Calculators and races

Work for any Kracey account, with nothing connected.

Predict a HYROX finish time

predict_hyrox_time

Predicts a HYROX finish time for a division from running ability: either a recent race result (distance and time) or the pace per kilometre the athlete would run inside the race. Returns the total, the split between running, stations and Roxzone, and every lap in race order with the clock after each station. Needs no training data.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It computes from its inputs and Kracey's own model, and reaches no outside system.

Pacing for a HYROX goal time

plan_hyrox_pacing

Works a HYROX goal time backwards for a division: the run pace per kilometre it needs, the time available for the stations and Roxzone, every lap in race order with the clock after each station, and the 10K time that running pace corresponds to. Needs no training data.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It computes from its inputs and Kracey's own model, and reaches no outside system.

Predict running race times

predict_race_times

From one running result, predicts the 5K, 10K, half marathon and marathon by two standard methods (Riegel and Daniels), with the pace for each. Needs no training data.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It computes from its inputs and Kracey's own model, and reaches no outside system.

Find hybrid fitness races

find_races

Searches Kracey's race directory for upcoming HYROX and other hybrid fitness races by brand, country and date, with the venue type, the divisions, where to register, and the altitude and typical temperature for the race month. Needs no training data.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It searches a fixed list Kracey maintains, not the web.

Heart and recovery

Only if you tick Heart and recovery data. Heart rate in your sessions comes with it too.

Fitness, fatigue and form

get_fitness

The athlete's training load model from intervals.icu: fitness (CTL), fatigue (ATL), form (TSB), how fitness changed over four weeks, the ratio of recent to longer-term load, the weekly ramp rate, and VO2max with the date it was measured. Only available when the athlete chose to share heart and recovery data.

Scope: Heart and recovery data
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Heart rate zones by method

get_zones

The athlete's running heart rate zones worked out several ways side by side (threshold, percent of max, heart rate reserve, and the zones set in intervals.icu), each with the inputs it used and whether those were measured or typed in. Only available when the athlete chose to share heart and recovery data.

Scope: Heart and recovery data
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Sleep, HRV and resting heart rate

get_recovery

The athlete's recovery readings: last night's sleep and the seven-day average, HRV and resting heart rate with how far each sits from the athlete's own usual range over the last 30 days, and nightly sleep for the last two weeks. Only available when the athlete chose to share heart and recovery data.

Scope: Heart and recovery data
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

With the Kracey coach

For athletes who have a coach plan.

The coach's current plan

get_plan

The sessions the Kracey coach has planned for this athlete from today for the next two weeks: date, time, title, kind of session, distance, duration and intensity. Read only.

Scope: Training, listed only if you have a Kracey coach plan
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reads this athlete's Kracey account only, not the web or any other system.

Not included

Building a plan, changing it and race week preparation answer that they need the coach.

Build a training plan

build_plan

Would build a training plan around the athlete's race, week and recent training. Not included in this connection: it answers with where the Kracey coach's plans are described.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reaches no system at all.

Change the training plan

edit_plan

Would move, swap or rewrite sessions in the athlete's plan. Not included in this connection: it answers with where the Kracey coach's plans are described.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reaches no system at all.

Race week preparation

race_prep

Would lay out the final days before a race. Not included in this connection: it answers with where the Kracey coach's plans are described.

Scope: Training
Changes: Nothing. It writes nothing, so there is nothing it could delete or overwrite.
Reaches: It reaches no system at all.