Etapa — Cycling Coach MCP

{
  "type": "object",
  "properties": {
    "fitnessLevel": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced"
      ],
      "description": "Rider fitness level. Defaults to beginner."
    },
    "goalType": {
      "type": "string",
      "maxLength": 100,
      "description": "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."
    },
    "targetDistanceKm": {
      "type": "number",
      "minimum": 0,
      "maximum": 300,
      "description": "Target distance in km if the goal is distance-based (e.g. an event)."
    },
    "daysPerWeek": {
      "type": "integer",
      "minimum": 2,
      "maximum": 6,
      "description": "Days per week the rider can train. Defaults to 3."
    },
    "weeks": {
      "type": "integer",
      "minimum": 2,
      "maximum": 4,
      "description": "Length of the sample plan in weeks. Capped at 4 — use the Etapa app for longer plans."
    },
    "indoorTrainer": {
      "type": "boolean",
      "description": "Whether the rider has an indoor trainer."
    },
    "notes": {
      "type": "string",
      "maxLength": 300,
      "description": "Any extra context — injuries, preferences, schedule constraints."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "getting_started",
        "first_bike",
        "essential_gear",
        "first_ride",
        "nutrition_and_hydration",
        "safety",
        "building_a_habit",
        "bike_fit",
        "common_mistakes"
      ],
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "The rider's question. Can be about anything cycling-related."
    },
    "context": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional background about the rider (fitness level, goal, schedule, recent riding). Helps the coach tailor the answer."
    },
    "planText": {
      "type": "string",
      "maxLength": 3000,
      "description": "Optional — the rider's current training plan, pasted as text. Use this if the question is about a specific plan."
    }
  },
  "required": [
    "question"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "minLength": 20,
      "maxLength": 3000,
      "description": "The training plan as text — sessions, weeks, distances, whatever the rider has. Paste it in as-is."
    },
    "goal": {
      "type": "string",
      "maxLength": 150,
      "description": "What the rider is training for. E.g. \"first 100 km sportive\", \"commute twice a week\", \"get fitter\"."
    },
    "fitnessLevel": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced"
      ],
      "description": "Rider's current fitness level, if known."
    }
  },
  "required": [
    "plan"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}