SuperTours.ru Tour Search

Search tours and excursions on supertours.ru by destination, category, price range (currency-aware), duration (in HOURS), start time of day, activity level, kids-allowed flag. Returns a paginated list with name, slug, base price, duration, settlement, country, rating and reviews count. Use list_tour_categories / list_regions / list_settlements to resolve names to IDs before calling this tool with filter IDs. (RU: Поиск туров и экскурсий с фильтрами по городу, категории, цене, длительности, времени и активности.)

{
  "type": "object",
  "properties": {
    "input": {
      "type": "object",
      "properties": {
        "activityLevelIds": {
          "description": "Activity level IDs. Higher value = more physical effort.",
          "type": "array",
          "items": {
            "type": "integer",
            "format": "int64",
            "description": "Activity level IDs. Higher value = more physical effort."
          }
        },
        "childrenAllowed": {
          "type": "boolean",
          "description": "Only tours that allow kids."
        },
        "countryId": {
          "type": "integer",
          "format": "int64",
          "description": "Country ID. Resolve via list_settlements (item.country)."
        },
        "currencyId": {
          "type": "integer",
          "format": "int64",
          "description": "Currency ID. Defaults to RUB. Backend rescales prices for non-RUB tours."
        },
        "exclusiveTour": {
          "type": "boolean",
          "description": "Only exclusive (group-limited) tours."
        },
        "maxDurationHours": {
          "type": "integer",
          "format": "int32",
          "description": "Maximum tour duration in HOURS."
        },
        "maxPrice": {
          "type": "number",
          "format": "double",
          "description": "Maximum price in the selected currency."
        },
        "minDurationHours": {
          "type": "integer",
          "format": "int32",
          "description": "Minimum tour duration in HOURS."
        },
        "minPrice": {
          "type": "number",
          "format": "double",
          "description": "Minimum price in the selected currency."
        },
        "page": {
          "type": "integer",
          "format": "int32",
          "description": "Page number, 0-based. Default 0."
        },
        "settlementId": {
          "type": "integer",
          "format": "int64",
          "description": "Settlement ID. Resolve via list_settlements."
        },
        "size": {
          "type": "integer",
          "format": "int32",
          "description": "Page size (default 10, max 20)."
        },
        "sort": {
          "type": "string",
          "description": "Sort order: POPULARITY (default), PRICE_ASC, PRICE_DESC."
        },
        "startTimes": {
          "description": "Start time of day: MORNING, DAY, EVENING. (RU: время начала)",
          "type": "array",
          "items": {
            "type": "string",
            "description": "Start time of day: MORNING, DAY, EVENING. (RU: время начала)"
          }
        },
        "textQuery": {
          "type": "string",
          "description": "Free-text query — place name, tag, category. (RU: текстовый поиск)"
        },
        "tourCategoryIds": {
          "description": "Tour category IDs. Resolve via list_tour_categories.",
          "type": "array",
          "items": {
            "type": "integer",
            "format": "int64",
            "description": "Tour category IDs. Resolve via list_tour_categories."
          }
        }
      }
    }
  },
  "required": [
    "input"
  ],
  "additionalProperties": false
}

Get full tour details by slug or UUID. Returns description, schedule, duration, base price, settlement and category. Use this after search_tours to fetch the full description for a selected tour. (RU: Полные детали тура по slug или UUID.)

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Tour slug (preferred) or UUID. (RU: slug или UUID тура)"
    }
  },
  "required": [
    "identifier"
  ],
  "additionalProperties": false
}

List Russian regions (subjects of the Russian Federation) with optional name prefix filter. Returns region ID, name and timezone. Currently region IDs are only attached to Russian settlements; for foreign destinations use list_settlements instead. (RU: Список регионов России для уточнения географии.)

{
  "type": "object",
  "properties": {
    "textQuery": {
      "type": "string",
      "description": "Optional name prefix filter (≥ 1 char)."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "description": "Page number, 0-based. Default 0."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "description": "Page size (default 10, max 20)."
    }
  },
  "required": [],
  "additionalProperties": false
}

Autocomplete settlements (cities, towns, villages) by name prefix. Returns settlement ID, localized + international name, type, region, country and coordinates. Use to resolve a user phrase like "Sochi" into a settlementId filter for search_tours. (RU: Автодополнение населённых пунктов.)

{
  "type": "object",
  "properties": {
    "textQuery": {
      "type": "string",
      "description": "Name prefix (≥ 2 chars recommended). Either textQuery or internationalName should be set."
    },
    "internationalName": {
      "type": "string",
      "description": "International (Latin) name match. Useful for foreign destinations."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "description": "Page number, 0-based. Default 0."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "description": "Page size (default 10, max 20)."
    }
  },
  "required": [],
  "additionalProperties": false
}

List all tour categories with ID and localized name. Use this to translate user phrases like "wine tasting" into tourCategoryIds filter for search_tours. (RU: Справочник категорий туров.)

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Get the most viewed tours (by view count, then recency). Use to give an agent quick recommendations when the user is undecided. (RU: Самые популярные туры — для общих рекомендаций.)

{
  "type": "object",
  "properties": {
    "size": {
      "type": "integer",
      "format": "int32",
      "description": "Number of tours to return (default 10, max 20)."
    }
  },
  "required": [],
  "additionalProperties": false
}

List user reviews for a tour by slug or UUID. Returns rating, author name, text and trip date for each review, plus average rating for the page. Use after get_tour to substantiate recommendations with real-customer feedback. (RU: Отзывы пользователей на тур.)

{
  "type": "object",
  "properties": {
    "tourIdentifier": {
      "type": "string",
      "description": "Tour slug or UUID."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "description": "Page number, 0-based. Default 0."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "description": "Page size (default 10, max 20)."
    }
  },
  "required": [
    "tourIdentifier"
  ],
  "additionalProperties": false
}