MCP 服务器

mcp-supertours

Tour and excursion search on supertours.ru — destinations across Russia and abroad.

README

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:

{
  "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):

{
  "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:

https://mcp.supertours.ru/sse

Quick sanity check

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