GuruWalk MCP Server

О GuruWalk

GuruWalk — крупнейшая в мире платформа бесплатных пешеходных экскурсий, объединяющая путешественников с местными гидами в более чем 1000 городах в 120+ странах. Основанная в 2017 году в Валенсии, Испания, платформа работает по уникальной модели «плати сколько хочешь» для бесплатных туров: путешественники бронируют бесплатно и дают чаевые гиду в зависимости от полученных впечатлений.

Наряду с бесплатными пешеходными экскурсиями, GuruWalk предлагает платные мероприятия, включая экскурсии с гидом, билеты без очереди, гастрономические впечатления, однодневные поездки и многое другое — всё можно забронировать в одном месте.

1000+

Городов по всему миру

4000+

Местных гидов

2M+

Проверенных отзывов

4

Языка

Что это?

MCP-сервер GuruWalk позволяет AI-ассистентам искать направления, просматривать категории, проверять доступность и получать полную информацию о турах — не выходя из диалога. Работает с любым MCP-совместимым клиентом.

URL сервера

https://back.guruwalk.com/mcp

Протокол

MCP (Model Context Protocol) через Streamable HTTP

Аутентификация

Не требуется

Тип

Только чтение

Настройка

Claude.ai / Claude Desktop

1. Перейдите в Настройки → Коннекторы
2. Нажмите кнопку + и выберите «Обзор коннекторов»
3. Найдите «GuruWalk» и нажмите +, чтобы добавить
4. Начните общаться о туристических направлениях

Claude Code

claude mcp add --transport http guruwalk https://back.guruwalk.com/mcp

Любой MCP-клиент

Укажите вашему MCP-клиенту адрес:

https://back.guruwalk.com/mcp

API-ключ или аутентификация не требуются. Работает с любым клиентом, поддерживающим MCP через Streamable HTTP.

Также доступен в Smithery, реестре MCP-серверов.

ChatGPT

У GuruWalk есть специальное приложение ChatGPT с 5 инструментами и интерактивными карточками. См. документацию приложения ChatGPT.

Доступные инструменты

🔍

search_tours_activities_by_destination

Поиск города для изучения бесплатных пешеходных экскурсий и платных мероприятий на GuruWalk, крупнейшей в мире платформе бесплатных пешеходных экскурсий. Возвращает информацию о направлении, категории туров (бесплатные туры, гастрономические туры, однодневные поездки, билеты и многое другое) и избранные предложения с рейтингами и проверенными отзывами путешественников. Охватывает 1000+ городов по всему миру. Бесплатные туры работают по модели «плати сколько хочешь». Поддерживаются английский, испанский, немецкий и итальянский языки — аргумент language ДОЛЖЕН быть одним из: en, es, de, it. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника. Используйте этот инструмент, когда путешественник спрашивает, чем заняться, что посмотреть или какие туры и мероприятия доступны в пункте назначения, или хочет спланировать поездку или дни там. Не вызывайте его, если пункт назначения упоминается вскользь без запроса планов или рекомендаций. Если путешественник упоминает достопримечательность вместо города, определите город (например, «эйфелева башня» → Париж, «колизей» → Рим, «саграда фамилия» → Барселона, «биг бен» → Лондон). После получения результатов просмотрите категории и featured_products, чтобы найти наиболее подходящие варианты для запроса путешественника.

Входные данные: destination (город), country (опционально), диапазон дат, размер группы, language (en/es/de/it)

📂

get_tours_activities_by_category

Просмотр туров и мероприятий в определенной категории для пункта назначения на GuruWalk. Категории включают бесплатные пешеходные экскурсии, гастрономические туры, велотуры, однодневные поездки, билеты без очереди и многое другое. Возвращает предложения с рейтингами, количеством проверенных отзывов, продолжительностью, доступными языками и ценами. Используйте идентификаторы категорий, возвращенные search_tours_activities_by_destination — никогда не придумывайте идентификаторы категорий. Используйте этот инструмент, чтобы углубиться в конкретную категорию, соответствующую запросу путешественника (например, гастрономические туры для гурмана, ночные туры для тех, кто спрашивает о вечерних мероприятиях, мероприятия для детей для семей). Поддерживаются en, es, de, it — аргумент language ДОЛЖЕН быть одним из этих четырех кодов. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника.

Входные данные: vertical_id (идентификатор категории из search_tours_activities_by_destination), hub_slug (для бесплатных туров), размер группы, language

📅

get_product_availability

Проверка доступности в реальном времени для одного или нескольких туров или мероприятий на GuruWalk за один вызов. Передайте массив items\ — каждая запись независима и имеет свой тип, product_id и диапазон дат. Возвращает массив results\, где каждая запись повторяет свои type\ и product\_id\, чтобы вы могли сопоставить каждый ответ с его запросом. Всегда группируйте запросы при проверке нескольких туров: отправляйте их все в одном вызове, а не вызывайте этот инструмент несколько раз. Для платных мероприятий показывает тарифы по типу путешественника (взрослый, ребенок, младенец). price\ всегда указана за человека — никогда не указывайте общую сумму для группы, ссылаясь только на price\. Если в тарифе присутствует total\_price\, она уже рассчитана для указанных вами участников этого типа тарифа — указывайте ее напрямую, не умножайте и не делите самостоятельно. Если группа состоит из разных типов путешественников (например, взрослые и дети), суммируйте total\_price\ каждого тарифа для получения общей суммы группы. Для бесплатных пешеходных экскурсий предварительная цена отсутствует — путешественники платят сколько хотят после тура. Включает прямые ссылки для бронирования. Максимальный диапазон дат на элемент: 5 дней. Ошибки по отдельным элементам (неверные даты, продукт не найден) сообщаются в результате этого элемента, не прерывая обработку остальной части пакета. Используйте этот инструмент, когда путешественник спрашивает о конкретных датах, хочет узнать, доступно ли что-то, или готов забронировать. Если путешественник не указал конкретные даты, используйте дату бронирования ±2 дня в качестве диапазона поиска по умолчанию. Поддерживаются en, es, de, it — аргумент language ДОЛЖЕН быть одним из этих четырех кодов. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника.

Входные данные: items[] — каждый с type (product/free_tour), product_id, диапазоном дат, участниками, language

📋

get_product_detail

Получение полной информации об одном или нескольких турах или мероприятиях на GuruWalk за один вызов. Передайте массив items\ — каждая запись имеет свой тип, product_id и language и обрабатывается независимо. Возвращает массив results\, где каждая запись повторяет свои product\_id\ и type\, чтобы вы могли сопоставить каждый ответ с его запросом. Всегда группируйте запросы, когда вам нужны сведения о нескольких турах (например, перед рекомендацией или сравнением): отправляйте их все в одном вызове, а не вызывайте этот инструмент несколько раз. Каждая успешная запись возвращает описание, изображения, отзывы, продолжительность, доступные языки, правила отмены и информацию о месте встречи. Платные записи product\ также возвращают highlights\, included\/excluded\, pricing\_from\ и where\ (адрес + координаты). Записи free\_tour\ возвращают itinerary\ в виде плоского массива строк «точка-название» (без описаний), а также guide.name\, meeting\_point\_url\ и how\_to\_find\_me\. Формат места встречи различается по типу: платные product\ возвращают текст адреса и координаты в where\; free\_tour\ возвращают meeting\_point\_url\ (ссылку на Google Maps), meeting\_point\_latitude\ и meeting\_point\_longitude\ (используйте эти координаты как пункт назначения для маршрута), а также how\_to\_find\_me\: текстовое примечание, написанное гидом, описывающее, как путешественник может узнать его на месте встречи. Ошибки по отдельным элементам (продукт не найден) сообщаются в результате этого элемента, не прерывая обработку остальной части пакета. Используйте этот инструмент всякий раз, когда путешественник спрашивает, что включает тур, какие места он посещает, его маршрут, описание, место встречи, продолжительность или любой вопрос, связанный с содержанием. Всегда вызывайте этот инструмент ПЕРЕД ответом на вопросы о конкретном туре — никогда не давайте общих мнений или советов, не сверившись сначала с реальными данными. Поддерживаются en, es, de, it — аргумент language ДОЛЖЕН быть одним из этих четырех кодов. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника.

Входные данные: items[] — каждый с product_id, type (product/free_tour), language

Поддерживаемые языки

Все инструменты поддерживают четыре языка через параметр language. Результаты поиска туров, описания и категории возвращаются на запрошенном языке, если доступны.

en Английский (по умолчанию)

es Испанский

de Немецкий

it Итальянский

Что с этим можно делать?

Спросите своего AI-ассистента о чем угодно, касающемся туров и мероприятий — он выполнит поиск по полному каталогу GuruWalk в реальном времени.

Найти бесплатные пешеходные экскурсии в любом городеsearch_tours_activities_by_destination → get_tours_activities_by_category

Сравнить гастрономические туры по рейтингуget_tours_activities_by_category → get_product_detail

Проверить места на конкретную датуget_product_availability

Получить маршрут и место встречиget_product_detail

Спланировать полный день с экскурсиямиsearch_tours_activities_by_destination → get_product_availability

Найти ночные туры в городеget_tours_activities_by_category

Узнать, что включено в турget_product_detail

Открыть для себя однодневные поездки и экскурсииget_tours_activities_by_category

Популярные направления

GuruWalk охватывает 1000+ городов по всей Европе, Америке, Азии, Африке и Океании. Лучшие направления включают Рим, Барселону, Париж, Лондон, Стамбул, Лиссабон, Прагу, Будапешт, Флоренцию, Вену, Амстердам, Берлин, Мадрид, Порту, Дублин, Эдинбург, Нью-Йорк, Токио, Бангкок, Севилью, Венецию, Краков, Мюнхен, Дубровник, Брюссель, Стокгольм, Копенгаген, Сан-Франциско, Тирану и Софию — новые города добавляются регулярно.

Каждое направление предлагает сочетание бесплатных пешеходных экскурсий (плати сколько хочешь), экскурсий с гидом, билетов без очереди, гастрономических и винных туров, велотуров, однодневных поездок и многого другого. Используйте search_tours_activities_by_destination с названием любого города, чтобы увидеть, что доступно.

Примеры использования

Откройте для себя направление

Запрос: «Чем заняться в Барселоне?»

Найдено 170+ туров и мероприятий в Барселоне. Бесплатные пешеходные экскурсии: Старый город: Готический квартал и Эль Борн (★4.8, 7200+ отзывов), Раскройте секреты Барселоны (★4.9). Лучшие платные впечатления: Экскурсия с гидом по Саграда Фамилия (от €48), Вход в Каса Батльо (от €29, 11000+ отзывов), Шоу фламенко во дворце Далмасес (от €25). Категории: Бесплатные туры, Билеты в Саграда Фамилия, Гастрономические туры, Велотуры, Туры по Готическому кварталу, Шоу фламенко...

Просмотр категории

Запрос: «Покажи винные туры в Барселоне»

Найдено 46 винных впечатлений в Барселоне. В городе: Дегустация вина + сыра (1ч, ★4.56), Обед на продовольственном рынке с винной парой (2.5ч, ★5.0), Винно-тапасный тур на электровелосипеде (3ч, от €69). Однодневные поездки: Винный тур в Монсеррат (7.5ч, ★4.82, 94 отзыва), Тур по виноградникам Пенедеса на внедорожнике (5.5ч), Монсеррат + вино и кава в малой группе (10ч, ★4.69)...

Проверка доступности

Запрос: «Есть ли места на экскурсию с гидом по району с тапас в следующую субботу?»

Два варианта на следующую субботу, 21 марта: Тур по району Барселоны с дегустацией традиционных тапас (3ч, 92€/чел) — доступно в 11:30 и 17:30. Экскурсия с гидом по тапас и вину в малой группе (3ч30, 89€/чел) — 17:30, 21 место доступно. Оба на английском языке.

Получение информации о туре

Запрос: «Расскажи подробнее о пешеходной экскурсии по центру Рима»

Пешеходная экскурсия по центру Рима, Треви, Пантеон и 11+ достопримечательностей (★4.96, 4445 отзывов, 2ч45). Эта бесплатная пешеходная экскурсия охватывает 11 остановок, включая фонтан Треви, Пантеон, Пьяцца Навона, Испанскую лестницу и район Колизея. Встреча на Пьяцца ди Спанья — ищите гида с табличкой. Доступна на английском языке. Доступна для колясок. Можно с домашними животными. Бронируйте бесплатно, платите сколько хотите в конце.

Конфиденциальность и безопасность

✓ Все инструменты только для чтения — данные не изменяются.

✓ Аутентификация не требуется — доступны только общедоступные данные о турах.

✓ Персональные данные не собираются и не хранятся.

✓ Политика конфиденциальности: guruwalk.com/terms/privacy_policy

Поддержка

• Справочный центр: support.guruwalk.com
• Email: support@guruwalk.com
• Веб-сайт: guruwalk.com
• Документация приложения ChatGPT: ai.guruwalk.com/docs/chatgpt
• Все интеграции: ai.guruwalk.com