Skip to main content
The Next Race logo
BlogContact
claude.aiCursorClaude CodeRacesPlansWorkoutsActivitiesPhysiology
https://www.thenextrace.app/mcp

Talk to your AI about your training.

Connect Claude, Cursor, and any MCP-compatible AI tool to your races, plans, workouts, scheduled sessions, completed activities, and physiology — and have a conversation.

Connect The Next Race to Claude.ai, Claude Desktop, Cursor, or Claude Code, and have a conversation with your training data. Ask about your races. Set your zones. Build your workout library by describing sessions.

The MCP server exposes tools for races, training plans, library workouts, scheduled sessions, completed activities, and your physiology — list, read, create, update, and delete — all authenticated with the same API token you use for the CLI.

Set it up

MCP

Settings → Connectors → Add custom connector. Paste:

https://www.thenextrace.app/mcp

Tools

Every tool below is exposed to the agent with detailed instructions — preconditions, enum values, and friendly aliases (e.g. marathon run_marathon).

whoami                            Current user, profile, paid status

list_races                        List races (filter by upcomingOnly)
get_race                          Single race with full detail
create_race                       Create race (optionally attach to a plan)
update_race                       Edit race fields, mark completed
delete_race                       Delete one race (keeps the plan)

list_plans                        List training plans
get_plan                          Single plan with share_token, mode, etc.
create_training_plan              Create empty plan (calendar or template)
update_plan                       Rename, switch mode, toggle public sharing
delete_plan                       Delete plan (cascades to its races)

list_library_workouts             List library workouts (filter by sport)
get_library_workout               Single library workout
create_library_workout            Save a reusable workout
update_library_workout            Edit a library workout
delete_library_workout            Delete (unless is_locked)

list_plan_workouts                Planned sessions inside a plan
schedule_workout                  Add a planned workout on a date
update_scheduled_workout          Move, edit, or link an actual activity
remove_scheduled_workout          Remove a planned session

list_activities                   Completed activities (filters incl. unlinked)
get_activity                      Single activity with splits and HR zones

get_profile                       Profile, physiology, system preferences
update_profile                    Merge into physiology (drives zones)

Try asking

  • “What races do I have planned this season?”
  • “Add the Berlin Marathon as my A-race on September 27.”
  • “Save this as a library workout: 6×3min at 5K pace, 3min jog recovery — call it ‘VO2 6×3’.”
  • “Update my FTP to 285 watts and run threshold pace to 4:05 per km.”
  • “Schedule a 90-minute Z2 ride in my Copenhagen plan next Tuesday.”
  • “Which of my recent Strava runs aren’t linked to a planned session yet?”