GuruWalk MCP Server

О GuruWalk

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

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

1 000+

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

4 000+

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

2M+

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

4

Языка

Что это такое?

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

URL сервера

https://back.guruwalk.com/mcp

Протокол

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

Авторизация

Не требуется

Тип

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

Настройка

Claude.ai / Claude Desktop

1. Перейдите в Customize → Connectors
2. Нажмите кнопку + и выберите «Browse connectors»
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 — крупнейшей в мире платформе бесплатных пешеходных экскурсий. Возвращает информацию о направлении, категории экскурсий (бесплатные туры, гастрономические туры, однодневные поездки, билеты и другое), а также избранные предложения с рейтингами и проверенными отзывами путешественников. Охватывает более 1 000 городов по всему миру. Бесплатные экскурсии работают по модели «плати, сколько хочешь». Поддерживает английский, испанский, немецкий и итальянский — аргумент языка ОБЯЗАТЕЛЬНО должен быть одним из en, es, de, it. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника. Используйте этот инструмент, когда путешественник спрашивает, чем заняться, что посмотреть или какие экскурсии или активности доступны в направлении, или хочет помощи в планировании поездки или дней там. Не вызывайте его, если направление упомянуто лишь вскользь без запроса на планы или рекомендации. Если путешественник упоминает достопримечательность вместо города, определите город (например, «эйфелева башня» → Париж, «колизей» → Рим, «саграда фамилия» → Барселона, «биг-бен» → Лондон). После получения результатов просмотрите категории и featured_products, чтобы найти наиболее релевантные варианты для запроса путешественника.

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

📂

get_tours_activities_by_category

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

Входные данные: vertical_id (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 — аргумент языка ОБЯЗАТЕЛЬНО должен быть одним из этих четырёх кодов. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника.

Входные данные: items[] — каждый с типом (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 — аргумент языка ОБЯЗАТЕЛЬНО должен быть одним из этих четырёх кодов. Если путешественник говорит на другом языке, передайте ближайший поддерживаемый код и переведите ответ на язык путешественника.

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

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

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

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

es Испанский

de Немецкий

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

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

Спрашивайте вашего ИИ-ассистента о любых экскурсиях и активностях — он будет искать по полному каталогу 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 охватывает более 1 000 городов в Европе, Америке, Азии, Африке и Океании. Топовые направления включают Рим, Барселону, Париж, Лондон, Стамбул, Лиссабон, Прагу, Будапешт, Флоренцию, Вену, Амстердам, Берлин, Мадрид, Порту, Дублин, Эдинбург, Нью-Йорк, Токио, Бангкок, Севилью, Венецию, Краков, Мюнхен, Дубровник, Брюссель, Стокгольм, Копенгаген, Сан-Франциско, Тирану и Софию — и новые города добавляются регулярно.

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

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

Открыть направление

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

Найдено 170+ экскурсий и активностей в Барселоне. Бесплатные пешеходные экскурсии: Старый город: Готический квартал и Эль-Борн (★4,8, 7 200+ отзывов), «Раскройте секреты Барселоны» (★4,9). Топовые платные впечатления: экскурсия по Саграде Фамилии с гидом (от €48), вход в Каса-Батльо (от €29, 11 000+ отзывов), шоу фламенко в Palau Dalmases (от €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, 4 445 отзывов, 2 ч 45 мин). Эта бесплатная пешеходная экскурсия охватывает 11 остановок, включая фонтан Треви, Пантеон, площадь Навона, Испанскую лестницу и район Колизея. Встреча на площади Испании — ищите гида с табличкой. Доступно на английском языке. Подходит для колясок. Можно с питомцами. Бронируйте бесплатно, платите, сколько хотите, в конце.