← back to overview

Tools reference

Anonymous read-only tools exposed over legacy HTTP+SSE at https://mcp.supertours.ru/sse. Connect the SSE long-poll there; the server announces the message-back URL in the first event: endpoint frame.

search_tours get_tour get_trending_tours get_tour_reviews list_tour_categories list_regions list_settlements

read

search_tours

Filter tours and excursions. Returns a paginated TourSummary list with slug, name, slogan, price, currency, duration, settlement and rating. Use list_settlements / list_tour_categories first to resolve names to IDs.

Parameters

Name	Type	Description
`textQuery`	string	Free-text query: place, tag or category name
`settlementId`	long	Settlement ID (city). Resolve via list_settlements
`countryId`	long	Country ID
`tourCategoryIds`	long[]	Category IDs (list). Resolve via list_tour_categories
`minPrice` / `maxPrice`	double	Price range in the selected currency
`currencyId`	long	Currency ID. Defaults to RUB; non-RUB tours are rescaled
`minDurationHours` / `maxDurationHours`	int	Tour duration range in HOURS
`activityLevelIds`	long[]	Activity level IDs (higher = more physical effort)
`startTimes`	string[]	Start time of day: `MORNING`, `DAY`, `EVENING`
`childrenAllowed`	bool	Only tours that allow kids
`exclusiveTour`	bool	Only exclusive (group-limited) tours
`sort`	string	`POPULARITY` (default), `PRICE_ASC`, `PRICE_DESC`
`page`	int	0-based page number (default 0)
`size`	int	Page size (default 10, max 20)

Sample response

{
  "items": [
    {
      "uuid": "550e8400-...",
      "slug": "ekskursiya-po-istoricheskomu-tsentru",
      "name": "Экскурсия по историческому центру",
      "basePrice": 1500.0,
      "currencyCode": "RUB",
      "durationMinutes": 180,
      "settlementName": "Москва",
      "countryName": "Россия",
      "rating": 4.7,
      "reviewsCount": 42,
      "url": "https://supertours.ru/tour/ekskursiya-po-..."
    }
  ],
  "page": 0, "size": 10, "totalItems": 137, "hasNext": true,
  "meta": { "canonicalUrl": "https://supertours.ru/searchTour", "disclaimer": "..." }
}

read

get_tour

Get full tour details by slug (preferred) or UUID. Returns description, schedule type, duration, base price, settlement, category, photo URLs and view count.

Parameters

Name	Type	Description
`identifier`	string	Tour slug (e.g. `ekskursiya-po-istoricheskomu-tsentru`) or UUID. Required.

read

get_trending_tours

Most-viewed tours of the recent period. Use for "recommend me a tour" prompts when the user hasn't named a city.

Parameters

Name	Type	Description
`size`	int	Number to return (default 10, max 20)

read

get_tour_reviews

User reviews for a tour. Returns rating, author name, text and created-at, plus average rating for the page.

Parameters

Name	Type	Description
`tourIdentifier`	string	Tour slug or UUID. Required.
`page`	int	0-based page number (default 0)
`size`	int	Page size (default 10, max 20)

reference

list_tour_categories

All tour categories with ID and localized name. Use to translate a user phrase ("wine tasting", "city walking", "skiing") into the tourCategoryIds filter for search_tours. No parameters.

reference

list_regions

Russian regions (subjects of the Russian Federation). Currently the region_id column is populated only for Russian settlements — for foreign destinations use list_settlements directly.

Parameters

Name	Type	Description
`textQuery`	string	Optional name prefix
`page`	int	0-based page number
`size`	int	Page size (default 10, max 20)

reference

list_settlements

Autocomplete cities, towns and villages by name prefix. Returns ID, localized + international name, type, region, country, lat/lon. This is the canonical way to turn "Sochi" into a settlementId for search_tours.

Parameters

Name	Type	Description
`textQuery`	string	Russian / localized name prefix (≥ 2 chars)
`internationalName`	string	Latin name match (useful for foreign destinations)
`page`	int	0-based page number
`size`	int	Page size (default 10, max 20)