# STAS Running Coach for Claude MCP server

Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.

## Links
- Registry page: https://www.getdrio.com/mcp/run-stas-stas
- Repository: https://github.com/hivrich/stas.run
- Website: https://stas.run

## Install
- Endpoint: https://stas.run/api/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://stas.run/api/mcp

## Tools
- get_user_summary - Start here for most conversations. Load the athlete's profile, goals, rules, recent load, current fitness context, performance evidence, planning guidance, and persistent STAS memory opportunities. Endpoint: https://stas.run/api/mcp
- get_trainings - Load recent workouts with pace, heart rate, sport metrics, intervals, and athlete reports. Use after the summary when analyzing load, progress, fatigue, or consistency. Endpoint: https://stas.run/api/mcp
- get_planned_events - Read planned events from the Intervals calendar in a date window. Use this before rewriting or replacing an existing STAS plan. Endpoint: https://stas.run/api/mcp
- whoami - Check which STAS user is currently authenticated. Use only for diagnostics or reconnect troubleshooting. Endpoint: https://stas.run/api/mcp
- create_plan_event - Create or update planned WORKOUT events in Intervals. This tool is self-contained; do not look for SKILL.md or examples in the athlete's calendar. dry_run is required: false writes the event, true previews only. Send activity_type as Run/Ride/Swim/Workout/WeightTraining/Other, stas_note for the human workout note, and external_id=plan:YYYY-MM-DD:<slug>. Do not send low-level Intervals fields category, type, sport, workoutType, description, workout_doc, icu_workout, filename, or file_contents. The server maps activity_type to Intervals type and category=WORKOUT. workout_builder is optional native Intervals.icu builder text for structured key workouts only, mainly Run/Ride intervals. Omit workout_builder for easy workouts, Swim, WeightTraining, and Other unless you have reliable structured steps. If you use workout_builder, do not include ## STAS or ## Workout; the server adds wrappers. Builder headers and repeat headers are plain lines without '-', e.g. 'Warmup', 'Main Set 5x', 'Cooldown'. Actual step lines start flush-left with '- ' and contain duration/distance plus a target, e.g. '- 1km 4:25/km-4:35/km Pace', '- 10m 75%', or '- Recovery 90s Z1 HR'. Do not write '- Warmup' followed by indented child bullets. Use '1km' or '1000mtr' for meters; 'm' means minutes. After writing a structured key workout, read it back with get_planned_events and check workout_doc.steps is non-empty before claiming it is structured. Example real interval write arguments. Replace the date/time and paces, but keep this exact JSON shape. Use activity_type, stas_note, and optional workout_builder. workout_builder contains only native Intervals.icu Workout Builder text: repeat headers do not start with "-", step lines are flush-left, and nested Markdown bullets are forbidden. {"dry_run":false,"events":[{"activity_type":"Run","name":"Intervals: 5x1000m","start_date_local":"2026-05-13T08:00:00","end_date_local":"2026-05-13T08:55:00","stas_note":"Goal: controlled interval work without overreaching.\nRule: if HR rises too fast or form breaks, stop after 4 reps.","workout_builder":"Warmup\n- 15m Z2 HR\n\nMain Set 5x\n- 1km 4:25/km-4:35/km Pace\n- Recovery 90s Z1 HR\n\nCooldown\n- 10m Z1 HR","external_id":"plan:2026-05-13:intervals-5x1000m","color":"green","moving_time":3300}]} Endpoint: https://stas.run/api/mcp
- create_note_event - Create or update NOTE events in Intervals. dry_run is required: false writes the note, true previews only. Send category=NOTE and external_id=note:YYYY-MM-DD:<slug>. Use all-day local times for normal notes, keep description short, and omit type, moving_time, icu_training_load, and workout_doc. Endpoint: https://stas.run/api/mcp
- delete_plan_events - Delete STAS plan events in a date window before writing a replacement plan, so old workouts do not remain in the calendar. dry_run is required: false deletes, true previews only. Endpoint: https://stas.run/api/mcp
- delete_note_events - Delete STAS note events in a date window before writing replacement notes. dry_run is required: false deletes, true previews only. Endpoint: https://stas.run/api/mcp
- save_strategy - Save the athlete's long-term STAS strategy only after explicit user confirmation. Strategy is a compact long-term roadmap, not a calendar, not a weekly plan, and not a full coaching analysis. Target length is about 2500-4500 characters; hard maximum is 5000 characters. Required markdown structure: Strategy updated, Goal/direction, Current point, Roadmap, Where we are now, Nearest working block, Week-building rules, Constraints/preferences, Review triggers, Unknowns/assumptions. Do not write day-by-day or 8-week calendar progression inside strategy; that belongs in block planning or calendar tools. Use for meaningful changes to goals, constraints, current position, roadmap, or long-term training logic, not for one-off weekly edits. Before calling this tool, show the user the exact full markdown that will be saved and ask for explicit confirmation. Never show one version and save another. Endpoint: https://stas.run/api/mcp
- read_profile_sections - Read controlled STAS profile memory sections with their hashes. Supports goals, rules, and profile when enabled by the server. Use the returned hash as previousHash before previewing a change. Endpoint: https://stas.run/api/mcp
- preview_profile_section_change - Create a controlled preview for a goals, rules, or profile memory section change. Prefer structured fields so the server builds the exact web-profile text; newText is a legacy fallback. This does not update the athlete profile. Before commit, show the user the exact full text from the preview and ask for explicit confirmation of that exact text. Visible confirmation copy is governed by a separate approved UX spec; do not invent final chat-copy inside this tool call. Endpoint: https://stas.run/api/mcp
- commit_profile_section_change - Commit a previously previewed goals, rules, or profile memory section change. Call this only after the user explicitly confirms the exact full text shown for that preview. The server updates the profile only if the section hash still matches the preview. Visible confirmation copy is governed by a separate approved UX spec. Endpoint: https://stas.run/api/mcp
- read_profile_change_history - Read goals, rules, or profile memory change history. Use this to inspect previewed, committed, restored, or expired changes before restore decisions. Endpoint: https://stas.run/api/mcp
- restore_profile_change - Restore a committed profile, goals, or rules profile memory change back to its previous text. Call this only after the user explicitly confirms the exact full text that will be restored. The server restores only if the current section still matches the committed change. Visible confirmation copy is governed by a separate approved UX spec. Endpoint: https://stas.run/api/mcp

## Resources
- stas://guide/what-stas-can-do - Short overview of what STAS can help with for an endurance athlete. MIME type: text/markdown
- stas://guide/how-to-ask - Short guidance on how the user should phrase requests to get the best result. MIME type: text/markdown
- stas://guide/plans-and-calendar - Rules for reading, replacing, and writing STAS plan items in the Intervals calendar. MIME type: text/markdown
- stas://guide/strategy - Explains the long-term strategy document and when it should be updated. MIME type: text/markdown

## Prompts
- start_here - Start a new STAS conversation the right way and ask for the next best step.
- show_current_fitness - Explain current fitness, recent load, and what matters most right now.
- analyze_recent_trainings - Review recent workouts and explain what they say about fitness and fatigue.
- build_next_week_plan - Create next week's training plan from fitness, goals, rules, and current calendar context.
- rewrite_current_plan - Read the current plan, rewrite it cleanly, and avoid duplicate STAS events.
- update_strategy - Review the current context and prepare an updated long-term strategy.

## Metadata
- Owner: run.stas
- Version: 1.0.2
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 17, 2026
- Source: https://registry.modelcontextprotocol.io