ru.supertours/tours

Official7 tools

by supertours

SuperTours.ru Tour Search

Search tours and excursions on supertours.ru by destination, price, duration, and rating.

Search and filter tours and excursions by destination, price, duration, and rating.

Topics

mcpmcp-servermodel-context-protocoltourismtourstravel

Captured live from the server via tools/list.

search_tours

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: Поиск туров и экскурсий с фильтрами по городу, категории, цене, длительности, времени и активности.)

Parameters (1)

inputobjectrequired

get_tour

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.)

Parameters (1)

identifierstringrequired
Tour slug (preferred) or UUID. (RU: slug или UUID тура)

list_regions

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: Список регионов России для уточнения географии.)

Parameters (3)

textQuerystring
Optional name prefix filter (≥ 1 char).
pageinteger
Page number, 0-based. Default 0.
sizeinteger
Page size (default 10, max 20).

list_settlements

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: Автодополнение населённых пунктов.)

Parameters (4)

textQuerystring
Name prefix (≥ 2 chars recommended). Either textQuery or internationalName should be set.
internationalNamestring
International (Latin) name match. Useful for foreign destinations.
pageinteger
Page number, 0-based. Default 0.
sizeinteger
Page size (default 10, max 20).

list_tour_categories

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: Справочник категорий туров.)

No parameters.

get_trending_tours

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

Parameters (1)

sizeinteger
Number of tours to return (default 10, max 20).

get_tour_reviews

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: Отзывы пользователей на тур.)

Parameters (3)

tourIdentifierstringrequired
Tour slug or UUID.
pageinteger
Page number, 0-based. Default 0.
sizeinteger
Page size (default 10, max 20).

README.md4 KBView on GitHub

supertours/mcp-server-public

Public manifest and install instructions for the supertours.ru MCP server — a Model Context Protocol server that lets AI agents (Claude, Cursor, ChatGPT, Cline, Continue and others) search tours and excursions on supertours.ru by destination, price, duration, rating and more.

MCP endpoint: https://mcp.supertours.ru/sse Landing & docs: https://mcp.supertours.ru/ · tools reference Transport: legacy HTTP+SSE (MCP spec 2025-06-18) Authentication: none — anonymous, read-only

What's exposed

Seven anonymous read-only tools:

Tool	Purpose
`search_tours`	Filter tours by destination (settlement / country), category, price range (currency-aware), duration (hours), start time of day, activity level, kids-allowed flag
`get_tour`	Full description, schedule, photos, tariffs by slug or UUID
`get_trending_tours`	Most-viewed tours of the recent period
`get_tour_reviews`	User reviews, rating, trip date
`list_tour_categories`	Resolve user phrases like "wine tasting" to category IDs
`list_regions`	Russian regions with timezone (use to scope a search to a federal subject)
`list_settlements`	Autocomplete cities/towns to settlement IDs (Russian and international)

Full input schemas and call examples on the tools reference page.

Install

Cursor

One-click install: open https://mcp.supertours.ru/ and press Install in Cursor.

Manual: add to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "supertours": {
      "url": "https://mcp.supertours.ru/sse",
      "type": "sse"
    }
  }
}

VS Code (Continue, Cline)

One-click: open https://mcp.supertours.ru/ and press Install in VS Code.

Claude Desktop

Claude Desktop talks to remote SSE servers through the mcp-remote proxy.

Add to ~/.claude/claude_desktop_config.json (macOS / Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "supertours-tours": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.supertours.ru/sse"]
    }
  }
}

ChatGPT (custom GPTs)

In the GPT builder → Configure → Add MCP server, paste:

code

https://mcp.supertours.ru/sse

Quick sanity check

bash

# Open SSE long-poll and read the first frame:
curl -N https://mcp.supertours.ru/sse
# expected:
#   id:<uuid>
#   event:endpoint
#   data:/mcp/message?sessionId=<uuid>

# Full handshake + tools/list (returns 7 tools):
npx --yes @modelcontextprotocol/inspector --cli \
    https://mcp.supertours.ru/sse --transport sse --method tools/list

Example prompts

Once installed, try these in your agent:

"Find a tour in Cappadocia under 300 EUR."
"Recommend three trending tours in Russia for the weekend."
"Show reviews for tour ekskursiya-po-istoricheskomu-tsentru."
"What categories of tours are available?"

The agent should call list_settlements / list_tour_categories to resolve names to IDs and then search_tours with the right filters.

Status & limits

Prices and availability are indicative — confirm at supertours.ru before booking.
Anonymous read-only; booking and chat-with-organizer endpoints will be added behind OAuth 2.1 in a follow-up release.
Rate limits at the proxy layer (60 search calls / minute per IP).

License

MIT — see LICENSE. The server source itself is private (part of taktilidu-server); this repository hosts the public install manifest and configuration only.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "tours": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.supertours.ru/sse"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

search_tours

get_tour

list_regions

list_settlements

list_tour_categories

get_trending_tours

get_tour_reviews

supertours/mcp-server-public

What's exposed

Install

Cursor

VS Code (Continue, Cline)

Claude Desktop

ChatGPT (custom GPTs)

Quick sanity check

Example prompts

Status & limits

Links

License

Install