SuperTours.ru Tour Search
mcpother officialSearch tours and excursions on supertours.ru by destination, price, duration, and rating.
run it
on your own machines, one way per deploy method# once, as root:
docker build -t mcp-local/tours:latest https://github.com/supertours/mcp-server-public.git
#!/usr/bin/env bash
# tours (ru.supertours/tours), recipe docker (generated).
# Generated by Hub for toolset "my-agent"; started by mcp-my-agent-tours.service.
set -euo pipefail
export HOST=127.0.0.1 PORT=8101
exec docker run --rm --name mcp-my-agent-tours -p 127.0.0.1:${PORT}:8000 mcp-local/tours:latest
[Unit]
Description=MCP server tours (toolset my-agent), generated by Hub
After=network-online.target docker.service
Wants=network-online.target
[Service]
Type=simple
User=mcp
Group=mcp
SupplementaryGroups=docker
EnvironmentFile=/etc/mcp/my-agent.env
Environment=HOME=/var/lib/mcp/tours
WorkingDirectory=/var/lib/mcp/tours
ExecStart=/opt/mcp/my-agent/bin/tours.sh
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/mcp/tours
[Install]
WantedBy=multi-user.target
docker build -t tours https://github.com/supertours/mcp-server-public.git docker run --rm -p 127.0.0.1:8101:8000 tours
# Generated by Hub for toolset "my-agent" (2026-10-18T21:09:51+00:00).
# Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
# cp .env.example .env # fill the ${VAR}s
# docker compose up -d && bash smoke.sh
# Remote servers are not here: clients reach them directly (see clients/).
name: mcp-my-agent
services:
tours:
build:
context: https://github.com/supertours/mcp-server-public.git
ports:
- 127.0.0.1:8101:8000
restart: unless-stopped
x-note: 'CHANGE_ME: built from the repository''s Dockerfile, assuming it serves streamable HTTP at
:8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.'
volumes:
npm-cache: {}
uv-cache: {}
# Generated by Hub for toolset "my-agent" (2026-10-18T21:09:51+00:00).
# kubectl create namespace mcp
# kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
# kubectl apply -f kubernetes.yaml
# Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
# with auth in front before exposing any of them.
apiVersion: v1
kind: Namespace
metadata:
name: mcp
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: tours
namespace: mcp
labels: &id001
app: tours
spec:
replicas: 1
selector:
matchLabels: *id001
template:
metadata:
labels: *id001
spec:
containers:
- name: tours
image: CHANGE_ME
ports:
- containerPort: 8000
name: http
env: []
---
apiVersion: v1
kind: Service
metadata:
name: tours
namespace: mcp
spec:
selector:
app: tours
ports:
- port: 8000
targetPort: http
name: http
# Generated by Hub for toolset "my-agent" (2026-10-18T21:09:51+00:00).
# Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
# Each server under `servers` is one Deployment + Service; the keys after it configure
# upstream charts a worker verified.
servers:
tours:
enabled: true
replicas: 1
port: 8000
path: /mcp
container:
name: tours
image: CHANGE_ME
ports:
- containerPort: 8000
name: http
env: []
# helm install my-agent helm/my-agent -n mcp
in the cloud
one click: the provider's deploy form opens filled in, in your own account- koyeb
-
Koyeb builds the repository's Dockerfile from branch main; change the branch in the form if the default one has another name.
Clients connect to the service's https://…koyeb.app address plus /mcp.
- cloud run
-
Cloud Shell clones the repository, builds its Dockerfile and deploys it to Cloud Run.
Cloud Run sends requests to $PORT (8080); the recipe expects :8000, so the server has to read PORT, or set the container port on the service afterwards.
connect to it
copy what your client needs{
"mcpServers": {
"tours": {
"command": "CHANGE_ME",
"args": []
}
}
}
#!/usr/bin/env bash # Registers every server with Claude Code (run once; `claude mcp list` to check). set -euo pipefail set -a; [ -f .env ] && source .env; set +a claude mcp add tours -- CHANGE_ME
{
"mcpServers": {
"tours": {
"command": "CHANGE_ME",
"args": []
}
}
}
{
"servers": {
"tours": {
"type": "stdio",
"command": "CHANGE_ME",
"args": []
}
}
}
name: my-agent target: local servers: - hub: ru.supertours/tours
- no recipe for target 'local': fill the files by hand
tools · 7
get_tourGet 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.)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.)
pin 66346f58cb67175f7e9aa1deecf366132f2ebcf463e259a8010b39ff42d58097get_tour_reviewsList 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: Отзывы пользователей на тур.)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: Отзывы пользователей на тур.)
pin 28d2aab4990ebbbb898d337f457e0ce52935f04191558315e706062a775b8bb4get_trending_toursGet the most viewed tours (by view count, then recency). Use to give an agent quick recommendations when the user is undecided. (RU: Самые популярные туры — для общих рекомендаций.)Get the most viewed tours (by view count, then recency). Use to give an agent quick recommendations when the user is undecided. (RU: Самые популярные туры — для общих рекомендаций.)
pin b06a75212edad5d574f47593dbff1e1b602111567194dfb7c3dd751e1ffb722blist_regionsList 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: Список регионов России для уточнения географии.)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: Список регионов России для уточнения географии.)
pin 19a6f5d46ccdaec04052444d50e04683dbb0c067cf5f230e8e65280daf429183list_settlementsAutocomplete 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: Автодополнение населённых пунктов.)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: Автодополнение населённых пунктов.)
pin f8bade5f269f2a436131a3b5472c3ee11057bad1c950c862c271975b1486a056list_tour_categoriesList all tour categories with ID and localized name. Use this to translate user phrases like "wine tasting" into tourCategoryIds filter for search_tours. (RU: Справочник категорий туров.)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: Справочник категорий туров.)
pin f8fd26a4f548ee9f41cf6bfd1591934bc25c4bb55d97394c35a4534f0a6f1f4csearch_toursSearch 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: Поиск туров и экскурсий с фильтрами по городу, категории, цене, длительности, времени и активности.)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: Поиск туров и экскурсий с фильтрами по городу, категории, цене, длительности, времени и активности.)
pin fc78f07232ea958cff5bf66627434228e858ad419d63b03ddb824a8e8b048238
runs · 1
the latest tests of this entry by the hub and its workers, newest first| date | worker | method | status | sandbox | reason |
|---|---|---|---|---|---|
| 2026-10-16 09:48 | local-mac | remotemcp 2024-11-05 | ok7 tools | none | — |