{
  "markdown": "# supertours/mcp-server-public\n\nPublic manifest and install instructions for the **supertours.ru MCP server** —\na Model Context Protocol server that lets AI agents (Claude, Cursor, ChatGPT,\nCline, Continue and others) search tours and excursions on\n[supertours.ru](https://supertours.ru) by destination, price, duration,\nrating and more.\n\n**MCP endpoint:** `https://mcp.supertours.ru/sse`\n**Landing & docs:** [`https://mcp.supertours.ru/`](https://mcp.supertours.ru/) · [tools reference](https://mcp.supertours.ru/tools)\n**Transport:** legacy HTTP+SSE (MCP spec 2025-06-18)\n**Authentication:** none — anonymous, read-only\n\n---\n\n## What's exposed\n\nSeven anonymous read-only tools:\n\n| Tool | Purpose |\n|------|---------|\n| `search_tours` | Filter tours by destination (settlement / country), category, price range (currency-aware), duration (hours), start time of day, activity level, kids-allowed flag |\n| `get_tour` | Full description, schedule, photos, tariffs by slug or UUID |\n| `get_trending_tours` | Most-viewed tours of the recent period |\n| `get_tour_reviews` | User reviews, rating, trip date |\n| `list_tour_categories` | Resolve user phrases like \"wine tasting\" to category IDs |\n| `list_regions` | Russian regions with timezone (use to scope a search to a federal subject) |\n| `list_settlements` | Autocomplete cities/towns to settlement IDs (Russian and international) |\n\nFull input schemas and call examples on the [tools reference page](https://mcp.supertours.ru/tools).\n\n---\n\n## Install\n\n### Cursor\n\nOne-click install: open [`https://mcp.supertours.ru/`](https://mcp.supertours.ru/) and press **Install in Cursor**.\n\nManual: add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"supertours\": {\n      \"url\": \"https://mcp.supertours.ru/sse\",\n      \"type\": \"sse\"\n    }\n  }\n}\n```\n\n### VS Code (Continue, Cline)\n\nOne-click: open [`https://mcp.supertours.ru/`](https://mcp.supertours.ru/) and press **Install in VS Code**.\n\n### Claude Desktop\n\nClaude Desktop talks to remote SSE servers through the `mcp-remote` proxy.\n\nAdd to `~/.claude/claude_desktop_config.json` (macOS / Linux) or\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"supertours-tours\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.supertours.ru/sse\"]\n    }\n  }\n}\n```\n\n### ChatGPT (custom GPTs)\n\nIn the GPT builder → **Configure** → **Add MCP server**, paste:\n\n```\nhttps://mcp.supertours.ru/sse\n```\n\n---\n\n## Quick sanity check\n\n```bash\n# Open SSE long-poll and read the first frame:\ncurl -N https://mcp.supertours.ru/sse\n# expected:\n#   id:<uuid>\n#   event:endpoint\n#   data:/mcp/message?sessionId=<uuid>\n\n# Full handshake + tools/list (returns 7 tools):\nnpx --yes @modelcontextprotocol/inspector --cli \\\n    https://mcp.supertours.ru/sse --transport sse --method tools/list\n```\n\n---\n\n## Example prompts\n\nOnce installed, try these in your agent:\n\n- *\"Find a tour in Cappadocia under 300 EUR.\"*\n- *\"Recommend three trending tours in Russia for the weekend.\"*\n- *\"Show reviews for tour `ekskursiya-po-istoricheskomu-tsentru`.\"*\n- *\"What categories of tours are available?\"*\n\nThe agent should call `list_settlements` / `list_tour_categories` to resolve\nnames to IDs and then `search_tours` with the right filters.\n\n---\n\n## Status & limits\n\n- Prices and availability are indicative — confirm at supertours.ru before booking.\n- Anonymous read-only; booking and chat-with-organizer endpoints will be added\n  behind OAuth 2.1 in a follow-up release.\n- Rate limits at the proxy layer (60 search calls / minute per IP).\n\n## Links\n\n- Web: <https://supertours.ru>\n- MCP landing: <https://mcp.supertours.ru/>\n- Tools reference: <https://mcp.supertours.ru/tools>\n- OAuth discovery (RFC 9728): <https://mcp.supertours.ru/.well-known/oauth-protected-resource>\n- Privacy policy: <https://supertours.ru/ru/documents/policy.pdf>\n- Contact: inbox@supertours.ru\n\n## License\n\nMIT — see [LICENSE](LICENSE). The server source itself is private\n(part of `taktilidu-server`); this repository hosts the public install\nmanifest and configuration only.\n",
  "bytes": 4079,
  "sha": "dc7d89eb26434cd82e9eb0acebeb802c6d9e45b2293bd643a49f64d04a877d01",
  "repo_slug": "supertours/mcp-server-public",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ru_supertours_tours_65e6a27a/readme"
}