Setup guide
Use Flux with your AI
Plan your training by chatting with Claude or ChatGPT. Here's what that means, why it's useful, and how to set it up in a few minutes.
What's MCP, in plain English?
MCP (Model Context Protocol) is the standard way AI apps plug into other apps. Think of it as a plug: Claude and ChatGPT have the socket, and Flux has the plug.
WITHOUT FLUX CONNECTED
"Make me a training plan."
"Sure! What's your FTP? How many days can you train? Do you have a race coming up? What did you ride last week?"
You answer twenty questions, get a plan back as text, then copy every workout into your calendar and your bike by hand.
WITH FLUX CONNECTED
"Make me a training plan."
"Your FTP is 262 and you've got the gravel race on May 3. I've built 12 weeks around your Tuesday, Thursday and Saturday rides. It's on your calendar, and the first two weeks are on your Karoo."
Your AI already knows your numbers, and the plan shows up where you train.
Why plan this way
A plan that's actually yours
Built from your fitness, races and schedule, not a template.
Changes in one sentence
"I'm away Thursday." "My legs are cooked." Ask, and the week adjusts.
Answers about your rides
"How did today compare to the plan?" It can see the data, so it can tell you.
No copying, anywhere
Changes go straight to your calendar, phone and head unit.
Set it up
You'll need a Flux account and an AI app that supports custom connectors. Check your AI app's plan if you don't see the setting.
Copy Flux's connector address
Add it to your AI app
Claude
- Open Settings → Connectors
- Click Add custom connector
- Name it Flux and paste the address
- Click Connect, then sign in to Flux
ChatGPT
- Open Settings → Apps & Connectors
- Under Advanced settings, turn on Developer mode
- Click Create and paste the address
- Choose OAuth for authentication and save
Other apps
- Add the address as a remote MCP connection
- It will ask you to sign in to Flux
Sign in to Flux and approve
A Flux page opens and shows exactly what the app will be able to see and change. Click Allow and you're connected.
Try asking
- "Build me a 12-week plan for my race in May"
- "I'm traveling Wednesday to Friday, move my workouts"
- "How did today's ride compare to the plan?"
- "Add two strength sessions a week"
What your AI can and can't do
Can see
Your profile (including heart rate, weight and age), rides, calendar and plans.
Can change
Upcoming workouts, plans, races and profile settings. Every change is listed in Flux.
Can't
Touch rides you've already done, or delete anything without showing you the list first.
Disconnect any time in Flux under Settings → Connected apps. It takes effect immediately. Read the privacy policy.
Questions
- Do I have to use an AI?
- No. Flux has its own workout builder and calendar. The AI is an extra way to plan.
- Does Flux run its own AI on my data?
- No. Flux runs no AI model over your data. The AI app you connect does, under that provider's terms.
- What if the AI makes a bad plan?
- Flux checks every plan against your availability, your equipment and your thresholds before saving it, and sends it back to the AI to fix if something's off.
- I don't see the connector setting.
- Custom connectors depend on your AI app and plan. Check your app's help pages for "custom connectors" or "MCP".
Full tool list (for the technically curious)
Read
- get_planning_context
- Your profile, zones, availability, fitness, races and active plans
- get_calendar
- Planned and completed sessions for a date range
- get_session
- One session in full: power, zones, intervals or logged sets
- list_training_plans
- Your training plans, newest first
- get_training_plan
- One plan with its blocks and workouts
- search_workout_library
- Find your saved workouts
- get_workout
- One saved workout's full structure
- search_exercises
- Find strength exercises that fit your equipment
- list_races
- Your races, soonest first
Write
- commit_plan
- Create or revise a whole plan, checked before saving
- end_plan
- End a plan early, after you confirm
- add_event
- Add one workout outside a plan
- update_event
- Move or change one planned workout
- delete_event
- Remove one scheduled workout, after you confirm
- create_race
- Add a race
- update_race
- Change a race's details
- delete_race
- Remove a race, after you confirm
- set_availability
- Mark dates you can't train, or can only train some ways
- delete_availability
- Clear an availability entry, after you confirm
- update_profile
- Change profile settings such as FTP or weekly availability
Server address: https://api.flux.dylanhoneyman.com/mcp · Standard OAuth sign-in · Works with any client that supports remote MCP servers.