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?”
