SuperTours.ru Tour Search
Search tours and excursions on supertours.ru by destination, price, duration, and rating.
Open source Repository Open in the app JSON README (API)
About
Search tours and excursions on supertours.ru by destination, price, duration, and rating.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- ru.supertours
- Origin
- official
- Category
- ferramentas
- Transport
- sse
- Version
- 1.0.0
- Last push
- 2026-05-27T21:13:11Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
ru.supertours/tours
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](https://supertours.ru) by destination, price, duration,
rating and more.
**MCP endpoint:** `https://mcp.supertours.ru/sse`
**Landing & docs:** [`https://mcp.supertours.ru/`](https://mcp.supertours.ru/) · [tools reference](https://mcp.supertours.ru/tools)
**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](https://mcp.supertours.ru/tools).
---
## Install
### Cursor
One-click install: open [`https://mcp.supertours.ru/`](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/`](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:
```
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).
## 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](LICENSE). The server source itself is private
(part of `taktilidu-server`); this repository hosts the public install
manifest and configuration only.