Resources
Everything you need to connect the AI-Intervals MCP server to your assistant.
1. Create your free intervals.icu API key
intervals.icu gives every athlete a personal API key. There is no OAuth dance to configure:
- Log in to intervals.icu.
- Go to Account → API keys (bottom of the page).
- Copy the 64-character key and note your athlete id, which looks like i12345.
2. Connect your account
Sign up, log in, then paste the API key and athlete id into the dashboard. AI-Intervals stores the key encrypted and only ever decrypts it in memory to make intervals.icu requests on your behalf.
3. Add the MCP server to your client
Create an API token in the dashboard, then configure a remote/streamable-http MCP server:
{ "mcpServers": { "ai-intervals": { "type": "http", "url": "https://pc.taila8fdfa.ts.net/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }
From the command line or scripts, the endpoint also speaks plain HTTP:
curl https://pc.taila8fdfa.ts.net/mcp \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Accept: application/json, text/event-stream" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
Available tools
Read all about the athlete, then act on the plan:
| Group | Tools |
|---|---|
| Read | get_athlete_profile get_training_history get_activity_detail get_events get_fitness get_wellness get_best_efforts get_power_curves get_sport_settings |
| Analyse | get_climb_segments get_extended_metrics get_training_summary get_ride_power_patterns |
| Coach | list_athletes select_athlete get_squad_summary compare_athletes |
| Write | push_workout edit_workout delete_workout push_wellness update_activity update_sport_settings |
The same list is served at https://pc.taila8fdfa.ts.net/.well-known/mcp/server-card.json.
Example prompts
Once connected, ask your assistant things like:
- "Summarize my training for this week and tell me my current fitness and fatigue."
- "What do my recent power curves and best efforts say about my running form?"
- "Plan a threshold workout for Saturday and add it to my calendar."
- "Read my latest activity and break down the intervals for me."
Security
- Passwords are hashed with scrypt; sessions live in SQLite with httpOnly, SameSite cookies.
- intervals.icu API keys are encrypted at rest (AES-256-GCM) with a per-deployment key.
- Every MCP request needs your Bearer token; tokens can be revoked instantly in the dashboard.
AI-Intervals is an independent product and is not affiliated with or endorsed by Intervals.icu.