surf-trip-planner

Use this when a user asks where to surf, where to fly for surf, how to plan a landlocked surfer trip, or which destinations fit their ability. Returns Strike Mission destination candidates with ability fit, season, travel, hazards, and dashboard links. For near-term trips (this month), candidates are ranked by live 10-day Strike Scores.

{
  "type": "object",
  "properties": {
    "surferLevel": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced",
        "expert"
      ],
      "description": "User ability level. Use intermediate when the user can catch green waves and go down the line.",
      "default": "intermediate"
    },
    "travelMonth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Target travel month from 1 to 12. Omit to use the current month."
    },
    "originAirport": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "Optional IATA origin airport, for example DEN, LAX, JFK, LHR, SYD."
    },
    "preferredRegions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional regions to prefer, for example Central America, Europe, Pacific, Southeast Asia."
    },
    "preferredCountries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional countries to prefer, for example Mexico, Costa Rica, Portugal."
    },
    "warmWaterOnly": {
      "type": "boolean",
      "description": "Set true when the user wants warm-water or boardshort-friendly surf.",
      "default": false
    },
    "budget": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "any"
      ],
      "description": "Budget preference for the trip.",
      "default": "any"
    },
    "avoidHeavyWaves": {
      "type": "boolean",
      "description": "Set true for beginners, intermediates, family trips, or anyone avoiding serious reef/slab conditions.",
      "default": true
    },
    "includeBoatAccess": {
      "type": "boolean",
      "description": "Set true if boat-only waves are acceptable.",
      "default": false
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Maximum number of recommendations.",
      "default": 6
    }
  },
  "additionalProperties": false
}

Use this when a user is deciding between specific countries, regions, or surf spots. Compares Strike Mission fit by ability level, season, travel access, hazards, consistency, and recommended spot candidates.

{
  "type": "object",
  "properties": {
    "destinations": {
      "type": "array",
      "minItems": 2,
      "maxItems": 8,
      "items": {
        "type": "string"
      },
      "description": "Countries, regions, or spot names to compare, for example Mexico, Costa Rica, Portugal, Bali, Uluwatu."
    },
    "surferLevel": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced",
        "expert"
      ],
      "description": "User ability level.",
      "default": "intermediate"
    },
    "travelMonth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Target travel month from 1 to 12. Omit to use the current month."
    }
  },
  "required": [
    "destinations"
  ],
  "additionalProperties": false
}

Use this when the user asks about a specific surf spot. Returns difficulty, hazards, season, travel access, wave type, swell/wind requirements, and Strike Mission links.

{
  "type": "object",
  "properties": {
    "spot": {
      "type": "string",
      "description": "Spot name, slug, or numeric Strike Mission spot id, for example Uluwatu, uluwatu, or 1."
    }
  },
  "required": [
    "spot"
  ],
  "additionalProperties": false
}

Use this when the user asks whether a specific surf spot is worth surfing or traveling to soon. Fetches the live 10-day Strike Mission forecast and best days for one spot.

{
  "type": "object",
  "properties": {
    "spot": {
      "type": "string",
      "description": "Spot name, slug, or numeric Strike Mission spot id, for example Uluwatu, uluwatu, or 1."
    }
  },
  "required": [
    "spot"
  ],
  "additionalProperties": false
}

Use this when the user wants surf trip planning guidance, such as landlocked surfer planning, where to surf next, avoiding flat trips, cheap surf flights, or Surfline alternatives.

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "enum": [
        "landlocked_surfer",
        "where_to_surf_next",
        "cheap_flights",
        "surfline_alternative",
        "avoid_flat_trip",
        "ai_surf_planner",
        "intermediate_destinations"
      ],
      "description": "The surf trip planning intent."
    },
    "query": {
      "type": "string",
      "description": "Optional free-form user query to match against guide titles and keywords."
    }
  },
  "additionalProperties": false
}