discover_collections

{
  "type": "object",
  "properties": {
    "neLat": {
      "type": "number",
      "description": "BOUNDS MODE: Northeast corner latitude. Required with swLat."
    },
    "neLng": {
      "type": "number",
      "description": "BOUNDS MODE: Northeast corner longitude. Required with swLat."
    },
    "swLat": {
      "type": "number",
      "description": "BOUNDS MODE: Southwest corner latitude. Use bounding box for geographic regions like coastlines, mountain ranges, lake shores, or any area that is not a single point. Example: Oregon coast → swLat=42.0, swLng=-124.8, neLat=46.3, neLng=-123.5."
    },
    "swLng": {
      "type": "number",
      "description": "BOUNDS MODE: Southwest corner longitude. Required with swLat."
    },
    "guests": {
      "type": "number",
      "description": "Number of guests"
    },
    "offset": {
      "type": "number",
      "description": "Skip this many results (for pagination / load-more). Default 0."
    },
    "region": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by state or region name (e.g., [\"Vermont\"], [\"Vermont\", \"New Hampshire\"]). Case-insensitive. Use this instead of bounding box when a guest asks for a specific state."
    },
    "sleeps": {
      "type": "number",
      "description": "Minimum sleeping capacity required (filters properties that sleep at least this many)"
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date (YYYY-MM-DD)"
    },
    "country": {
      "type": "string",
      "description": "Filter by ISO 3166-1 alpha-2 country code (e.g., \"US\"). Rarely needed since collections are typically in one country."
    },
    "feature": {
      "type": "string",
      "description": "Soft ranking signal — boost properties with a guest-confirmed feature. Does NOT hard-filter. Example values: \"mountain_views\", \"spotless_clean\", \"amazing_host\", \"cozy\", \"beachfront\", \"stocked_kitchen\", \"quiet_peaceful\"."
    },
    "nearLat": {
      "type": "number",
      "description": "POINT MODE: Latitude to search near (e.g. 35.789). Use for specific places like a town, address, or landmark. Resolve place names to coordinates before calling. For broad areas (coastlines, mountain ranges), use bounding box (swLat/neLat) instead."
    },
    "nearLng": {
      "type": "number",
      "description": "POINT MODE: Longitude to search near (e.g. -83.534). Required when nearLat is provided."
    },
    "persona": {
      "type": "string",
      "description": "Soft ranking signal — boost properties popular with a guest persona. Does NOT hard-filter. Example values: \"hiking\", \"young_family\", \"romantic\", \"pet_owners\", \"fishing\", \"honeymoon\", \"luxury\", \"foodie\"."
    },
    "bedrooms": {
      "type": "number",
      "description": "Minimum bedrooms needed"
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date (YYYY-MM-DD)"
    },
    "locality": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by city or town name (e.g., [\"Stowe\"], [\"Seaside\", \"Cannon Beach\"]). Case-insensitive. Use instead of geo when a guest asks for a specific town."
    },
    "nearUnit": {
      "enum": [
        "miles",
        "kilometers"
      ],
      "type": "string",
      "description": "Unit for nearRadius and distance values. Default \"miles\"."
    },
    "nearRadius": {
      "type": "number",
      "description": "POINT MODE: Max distance from the nearLat/nearLng point in nearUnit. Default 25 miles. Use 50+ for broad areas."
    },
    "preferences": {
      "type": "string",
      "description": "Free text preferences (e.g., \"hot tub, mountain view\")"
    },
    "petsRequired": {
      "type": "boolean",
      "description": "Whether guest needs pet-friendly property"
    },
    "maxProperties": {
      "type": "number",
      "description": "Max property picks to return. Default 5."
    },
    "propertySlugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "REPRICE / REHYDRATE mode (the carousel widget's date-change refresh). When set, return EXACTLY these properties re-priced for the dates, in this order — dropping any now unavailable for the dates and backfilling with the next-best similar available properties so the set keeps its size (\"same or slightly expanded\"). Lets a curated/merged carousel re-price across new dates without re-searching. Overrides offset/limit pagination."
    },
    "propertyTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Property type(s). The coarse family (house vs apartment) is the only hard filter; a specific subtype (e.g. \"cabin\", \"a-frame\") returns its whole family with that subtype boosted — cross-manager interleaving may still rank other family members above it; never zero results."
    },
    "semanticFilters": {
      "type": "object",
      "properties": {
        "required": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Natural-language must-haves. Every returned property must have listing, policy, amenity, or review evidence for each criterion; never infer a match from missing data."
        },
        "requested": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Natural-language preferences used as soft ranking signals. A property may still be returned when one or more requested preferences are not evidenced."
        }
      },
      "description": "Reserved optional evidence-backed semantic criteria that complement the explicit location, date, capacity, pet, property-type, and budget filters. Put true must-haves in `required`; put preferences that should improve ranking without excluding otherwise valid stays in `requested`. Until server instructions announce that semantic matching is enabled, omit this field.",
      "additionalProperties": false
    },
    "budgetMaxPerNight": {
      "type": "number",
      "description": "Max nightly budget in major currency units"
    },
    "collections": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Collection slug(s) — each a `collection_id` from list_collections. For search_bookables and discover_collections: OMIT to span the whole network, pass one to scope to a single manager, or several to compare across managers. For build_bookable_carousel: pass the collection_id(s) your chosen properties belong to — one, or several when the picks span managers. Every other tool operates on a single collection — pass exactly ONE."
    }
  }
}