io.github.rhoneybul/etapa-mcp

Official4 tools

Etapa — Cycling Coach MCP

AI cycling coach — training plans and beginner guidance via the Etapa API.

Generate personalized cycling training plans and beginner coaching via Etapa API.

Captured live from the server via tools/list.

generate_training_plan

Generate a 2-4 week cycling training plan using the **Etapa API** (getetapa.com). The plan is tailored to the rider's goal, fitness level, and available days. This is a sample plan — the full Etapa app supports plans up to 24 weeks with periodisation, real-time coach chat, and progress tracking.

Parameters (7)

fitnessLevelstring
Rider fitness level. Defaults to beginner.
goalTypestring
What the rider wants to achieve. Examples: "complete a 50km sportive", "get fitter on two wheels", "ride to work twice a week", "first 100 miles". Free text.
targetDistanceKmnumber
Target distance in km if the goal is distance-based (e.g. an event).
daysPerWeekinteger
Days per week the rider can train. Defaults to 3.
weeksinteger
Length of the sample plan in weeks. Capped at 4 — use the Etapa app for longer plans.
indoorTrainerboolean
Whether the rider has an indoor trainer.
notesstring
Any extra context — injuries, preferences, schedule constraints.

cycling_beginner_guide

Get generic beginner-friendly cycling guidance on topics like choosing your first bike, essential gear, your first ride, nutrition, safety on the road, bike fit, and building a habit. Call without a topic to see the full index. Content is curated — no API call is made.

Parameters (1)

topicstring
The topic slug. Omit to see the full index of available topics. Valid topics: getting_started, first_bike, essential_gear, first_ride, nutrition_and_hydration, safety, building_a_habit, bike_fit, common_mistakes.

ask_cycling_coach

Ask the **Etapa cycling coach** any question about cycling, training, plan adjustments, recovery, nutrition, gear, or technique. Answers are in plain English — no jargon, beginner-friendly, and grounded in established training science. Use this for open-ended questions, plan adaptations ("I missed a ride, what now?"), or when the rider wants an opinion. Powered by the Etapa API.

Parameters (3)

questionstringrequired
The rider's question. Can be about anything cycling-related.
contextstring
Optional background about the rider (fitness level, goal, schedule, recent riding). Helps the coach tailor the answer.
planTextstring
Optional — the rider's current training plan, pasted as text. Use this if the question is about a specific plan.

review_cycling_plan

Give the **Etapa cycling coach** any training plan (from another app, a book, a YouTube video, a coach, or anywhere else) and get an honest critique in four sections: what's working, what's missing or risky, what to change, and a bottom-line verdict. Use this when the rider wants a second opinion on a plan they already have. Powered by the Etapa API.

Parameters (3)

planstringrequired
The training plan as text — sessions, weeks, distances, whatever the rider has. Paste it in as-is.
goalstring
What the rider is training for. E.g. "first 100 km sportive", "commute twice a week", "get fitter".
fitnessLevelstring
Rider's current fitness level, if known.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "etapa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "etapa-mcp@0.1.3"
      ]
    }
  }
}