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

Links

• Web: https://supertours.ru
• MCP landing: https://mcp.supertours.ru/
• Tools reference: https://mcp.supertours.ru/tools
• OAuth discovery (RFC 9728): https://mcp.supertours.ru/.well-known/oauth-protected-resource
• Privacy policy: https://supertours.ru/ru/documents/policy.pdf
• Contact: inbox@supertours.ru

License

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