GuruWalk MCP Server

GuruWalk Hakkında

GuruWalk, dünyanın en büyük ücretsiz yürüyüş turu platformudur; gezginleri 120'den fazla ülkede 1.000'den fazla şehirde yerel rehberlerle buluşturur. 2017 yılında İspanya'nın Valensiya kentinde kurulan platform, ücretsiz turlar için benzersiz bir ne istersen öde modeliyle çalışır: gezginler ücretsiz rezervasyon yapar ve deneyimlerine göre rehbere bahşiş verir.

Ücretsiz yürüyüş turlarının yanı sıra GuruWalk; rehberli turlar, sıra beklemeden biletler, yemek deneyimleri, günübirlik geziler ve daha fazlasını içeren ücretli aktiviteler sunar — hepsi tek yerden rezerve edilebilir.

1.000+

Dünya genelinde şehir

4.000+

Yerel rehber

2M+

Doğrulanmış yorum

4

Dil

Bu Nedir?

GuruWalk'ın MCP sunucusu, yapay zeka asistanlarının sohbetten ayrılmadan destinasyon aramasına, kategorilere göz atmasına, müsaitlik kontrolü yapmasına ve tur detaylarının tamamını almasına olanak tanır. MCP uyumlu her istemciyle çalışır.

Sunucu URL'si

https://back.guruwalk.com/mcp

Protokol

Streamable HTTP üzerinden MCP (Model Context Protocol)

Kimlik Doğrulama

Kimlik doğrulama gerekmez

Tür

Salt okunur

Kurulum

Claude.ai / Claude Desktop

1. Özelleştir → Bağlayıcılar bölümüne gidin
2. + düğmesine tıklayın ve "Bağlayıcılara göz at" seçeneğini seçin
3. "GuruWalk" araması yapın ve eklemek için + düğmesine tıklayın
4. Seyahat destinasyonları hakkında sohbet etmeye başlayın

Claude Code

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

Herhangi Bir MCP İstemcisi

MCP istemcinizi şu adrese yönlendirin:

https://back.guruwalk.com/mcp

API anahtarı veya kimlik doğrulama gerekmez. Streamable HTTP üzerinden MCP destekleyen her istemciyle çalışır.

Ayrıca MCP sunucu kayıt defteri olan Smithery üzerinde de mevcuttur.

ChatGPT

GuruWalk'ın 5 araç ve etkileşimli kart içeren özel bir ChatGPT Uygulaması vardır. ChatGPT Uygulama belgelerine bakın.

Mevcut Araçlar

🔍

search_tours_activities_by_destination

Dünyanın en büyük ücretsiz yürüyüş turu platformu olan GuruWalk'ta ücretsiz yürüyüş turlarını ve ücretli aktiviteleri keşfetmek için bir şehir arayın. Destinasyon bilgisi, tur kategorileri (ücretsiz turlar, yemek turları, günübirlik geziler, biletler ve daha fazlası) ile puanlar ve doğrulanmış gezgin yorumları içeren öne çıkan listeleri döndürür. Dünya genelinde 1.000'den fazla şehri kapsar. Ücretsiz turlar ne istersen öde modeliyle çalışır. İngilizce, İspanyolca, Almanca ve İtalyanca destekler — dil argümanı MUTLAKA en, es, de, it değerlerinden biri olmalıdır. Gezgin başka bir dil konuşuyorsa, en yakın desteklenen kodu iletin ve yanıtı gezginin diline çevirin. Gezgin bir destinasyonda ne yapılacağını, ne görüleceğini veya hangi tur veya aktivitelerin mevcut olduğunu sorduğunda ya da seyahatini veya oradaki günlerini planlamak için yardım istediğinde bu aracı kullanın. Destinasyon yalnızca geçerken bahsediliyorsa ve plan veya öneri talebi yoksa bu aracı çağırmayın. Gezgin bir şehir yerine bir dönüm noktası belirtirse, şehri çıkarım yapın (ör. 'eyfel kulesi' → Paris, 'kolezyum' → Roma, 'sagrada familia' → Barselona, 'big ben' → Londra). Sonuçları aldıktan sonra, gezginin sorduğu şeyle en alakalı eşleşmeleri bulmak için kategorileri ve featured_products öğelerini inceleyin.

Girdi: destination (şehir), country (isteğe bağlı), tarih aralığı, grup büyüklüğü, language (en/es/de/it)

📂

get_tours_activities_by_category

GuruWalk'ta bir destinasyon için belirli bir kategorideki tur ve aktivitelere göz atın. Kategoriler arasında ücretsiz yürüyüş turları, yemek turları, bisiklet turları, günübirlik geziler, sıra beklemeden biletler ve daha fazlası bulunur. Puanlar, doğrulanmış yorum sayıları, süre, sunulan diller ve fiyatlandırma içeren listeleri döndürür. search_tours_activities_by_destination tarafından döndürülen kategori kimliklerini kullanın — asla kategori kimliği icat etmeyin. Bu aracı, gezginin paylaştığı şeyle eşleşen belirli bir kategoriye daha derinlemesine inmek için kullanın (ör. bir gurme için yemek turları, akşam hakkında soru soran biri için gece turları, aileler için çocuk dostu aktiviteler). en, es, de, it destekler — dil argümanı MUTLAKA bu dört koddan biri olmalıdır. Gezgin başka bir dil konuşuyorsa, en yakın desteklenen kodu iletin ve yanıtı gezginin diline çevirin.

Girdi: vertical_id (search_tours_activities_by_destination'dan kategori kimliği), hub_slug (ücretsiz turlar için), grup büyüklüğü, language

📅

get_product_availability

GuruWalk'ta bir veya daha fazla tur veya aktivite için gerçek zamanlı müsaitlik durumunu tek bir çağrıda kontrol edin. Bir items\ dizisi iletin — her girdi bağımsızdır ve kendi türü, product_id ve tarih aralığına sahiptir. Her girdinin kendi type\ ve product\_id\ değerini yansıttığı bir results\ dizisi döndürür; böylece her yanıtı kendi isteğiyle eşleştirebilirsiniz. Birden fazla turu kontrol ederken her zaman toplu işlem yapın: bu aracı birkaç kez çağırmak yerine hepsini tek bir çağrıda gönderin. Ücretli aktiviteler için gezgin türüne göre (yetişkin, çocuk, bebek) ücretleri gösterir. price\ her zaman kişi başınadır — price\ değerini tek başına alıntılayarak asla grup toplamı belirtmeyin. Bir ücrette total\_price\ mevcut olduğunda, bu zaten istediğiniz o ücret türündeki katılımcılar için hesaplanmıştır — doğrudan alıntılayın, kendiniz çarpmayın veya bölmeyin. Grup gezgin türlerini karıştırıyorsa (ör. yetişkinler ve çocuklar), tam grup toplamı için her ücretin total\_price\ değerini toplayın. Ücretsiz yürüyüş turları için önceden fiyat yoktur — gezginler turdan sonra ne isterse öder. Doğrudan rezervasyon bağlantıları içerir. Öğe başına maksimum tarih aralığı: 5 gün. Öğe başına hatalar (geçersiz tarihler, ürün bulunamadı), toplu işlemin geri kalanını etkilemeden o öğenin sonucu içinde bildirilir. Gezgin belirli tarihler sorduğunda, bir şeyin müsait olup olmadığını bilmek istediğinde veya rezervasyon yapmaya hazır olduğunda bu aracı kullanın. Gezgin belirli tarihler vermediğinde, varsayılan arama aralığı olarak rezervasyon tarihi ±2 gün kullanın. en, es, de, it destekler — dil argümanı MUTLAKA bu dört koddan biri olmalıdır. Gezgin başka bir dil konuşuyorsa, en yakın desteklenen kodu iletin ve yanıtı gezginin diline çevirin.

Girdi: items[] — her biri type (product/free_tour), product_id, tarih aralığı, katılımcılar, language içerir

📋

get_product_detail

GuruWalk'ta bir veya daha fazla tur veya aktivitenin tam detayını tek bir çağrıda alın. Bir items\ dizisi iletin — her girdinin kendi türü, product_id ve dili vardır ve bağımsız olarak işlenir. Her girdinin kendi product\_id\ ve type\ değerini yansıttığı bir results\ dizisi döndürür; böylece her yanıtı kendi isteğiyle eşleştirebilirsiniz. Birkaç tur için detaylara ihtiyacınız olduğunda (ör. önermeden veya karşılaştırmadan önce) her zaman toplu işlem yapın: bu aracı birkaç kez çağırmak yerine hepsini tek bir çağrıda gönderin. Başarılı her girdi açıklama, görseller, yorumlar, süre, sunulan diller, iptal politikaları ve buluşma noktası bilgilerini döndürür. Ücretli product\ girdileri ayrıca highlights\, included\/excluded\, pricing\_from\ ve where\ (adres + koordinatlar) döndürür. free\_tour\ girdileri itinerary\ değerini nokta-başlık dizelerinden oluşan düz bir dizi olarak (açıklamalar olmadan), ayrıca guide.name\, meeting\_point\_url\ ve how\_to\_find\_me\ döndürür. Buluşma noktası şekli türe göre değişir: ücretli product\ adres metnini artı where\ içindeki koordinatları döndürür; free\_tour\ meeting\_point\_url\ (Google Maps bağlantısı), meeting\_point\_latitude\ ve meeting\_point\_longitude\ (rota için bu koordinatları hedef olarak kullanın) artı how\_to\_find\_me\ döndürür: rehberin gezginin buluşma noktasında kendisini nasıl tanıyabileceğini açıklayan serbest metin notu. Öğe başına hatalar (ürün bulunamadı), toplu işlemin geri kalanını etkilemeden o öğenin sonucu içinde bildirilir. Gezgin bir turun neleri kapsadığını, hangi yerleri ziyaret ettiğini, güzergahını, rotasını, açıklamasını, buluşma noktasını, süresini veya içerikle ilgili herhangi bir soruyu sorduğunda bu aracı kullanın. Belirli bir tur hakkındaki soruları yanıtlamadan ÖNCE her zaman bu aracı çağırın — gerçek verilere danışmadan asla genel görüş veya tavsiye vermeyin. en, es, de, it destekler — dil argümanı MUTLAKA bu dört koddan biri olmalıdır. Gezgin başka bir dil konuşuyorsa, en yakın desteklenen kodu iletin ve yanıtı gezginin diline çevirin.

Girdi: items[] — her biri product_id, type (product/free_tour), language içerir

Desteklenen Diller

Tüm araçlar language parametresi aracılığıyla dört dili destekler. Tur sonuçları, açıklamalar ve kategoriler, mevcut olduğunda istenen dilde döndürülür.

en İngilizce (varsayılan)

es İspanyolca

de Almanca

it İtalyanca

Bununla Neler Yapabilirsiniz?

Yapay zeka asistanınıza turlar ve aktiviteler hakkında her şeyi sorun — GuruWalk'ın tüm kataloğunu gerçek zamanlı olarak arayacaktır.

Herhangi bir şehirde ücretsiz yürüyüş turları bulun search_tours_activities_by_destination → get_tours_activities_by_category

Yemek turlarını puana göre karşılaştırın get_tours_activities_by_category → get_product_detail

Belirli bir tarih için yerleri kontrol edin get_product_availability

Güzergah ve buluşma noktasını alın get_product_detail

Turlarla dolu bir gün planlayın search_tours_activities_by_destination → get_product_availability

Bir şehirde gece turları bulun get_tours_activities_by_category

Bir turda nelerin dahil olduğunu görün get_product_detail

Günübirlik gezileri ve ekskursiyonları keşfedin get_tours_activities_by_category

Popüler Destinasyonlar

GuruWalk, Avrupa, Amerika, Asya, Afrika ve Okyanusya genelinde 1.000'den fazla şehri kapsar. En popüler destinasyonlar arasında Roma, Barselona, Paris, Londra, İstanbul, Lizbon, Prag, Budapeşte, Floransa, Viyana, Amsterdam, Berlin, Madrid, Porto, Dublin, Edinburgh, New York, Tokyo, Bangkok, Sevilla, Venedik, Kraków, Münih, Dubrovnik, Brüksel, Stockholm, Kopenhag, San Francisco, Tiran ve Sofya bulunur — düzenli olarak yeni şehirler eklenir.

Her destinasyon, ücretsiz yürüyüş turları (ne istersen öde), rehberli deneyimler, sıra beklemeden biletler, yemek ve şarap turları, bisiklet turları, günübirlik geziler ve daha fazlasının bir karışımını sunar. Nelerin mevcut olduğunu görmek için herhangi bir şehir adıyla search_tours_activities_by_destination kullanın.

Kullanım Örnekleri

Bir destinasyonu keşfedin

İstek: "Barselona'da ne yapabilirim?"

Barselona'da 170'ten fazla tur ve aktivite bulundu. Ücretsiz yürüyüş turları: Eski Şehir: Gotik Mahalle ve El Born (★4.8, 7.200+ yorum), Barselona'nın Sırlarını Keşfedin (★4.9). En popüler ücretli deneyimler: Sagrada Família Rehberli Tur (48€'dan başlayan), Casa Batlló Giriş (29€'dan başlayan, 11.000+ yorum), Palau Dalmases'te Flamenko Gösterisi (25€'dan başlayan). Kategoriler: Ücretsiz Turlar, Sagrada Família Biletleri, Yemek Turları, Bisiklet Turları, Gotik Mahalle Turları, Flamenko Gösterileri...

Bir kategoriye göz atın

İstek: "Barselona'da şarap turlarını göster"

Barselona'da 46 şarap deneyimi bulundu. Şehirde: Şarap + Peynir Tadımı (1 saat, ★4.56), Şarap Eşliğinde Gıda Pazarı Öğle Yemeği (2,5 saat, ★5.0), Şarap ve Tapas E-Bisiklet Turu (3 saat, 69€'dan başlayan). Günübirlik geziler: Montserrat Şarap Turu (7,5 saat, ★4.82, 94 yorum), Penedès Bağları Off-Road Turu (5,5 saat), Montserrat + Şarap ve Cava Küçük Grup (10 saat, ★4.69)...

Müsaitlik kontrolü

İstek: "Gelecek cumartesi mahalle rehberli turunda tapas ile yer var mı?"

Gelecek cumartesi, 21 Mart için iki seçenek: Geleneksel Tapas Tadımlı Barselona Bölge Turu (3 saat, 92€/kişi) — 11:30 ve 17:30 müsait. Küçük Grup Rehberli Tapas ve Şarap Turu (3 saat 30 dk, 89€/kişi) — 17:30, 21 yer müsait. Her ikisi de İngilizce.

Tur detaylarını alın

İstek: "Roma Şehir Merkezi Yürüyüş Turu hakkında daha fazla bilgi ver"

Roma Şehir Merkezi Yürüyüş Turu, Trevi, Pantheon ve 11+ Turistik Yer (★4.96, 4.445 yorum, 2 saat 45 dk). Bu ücretsiz yürüyüş turu, Trevi Çeşmesi, Pantheon, Piazza Navona, İspanyol Merdivenleri ve Kolezyum bölgesi dahil 11 durağı kapsar. Piazza di Spagna'da buluşun — tabelalı rehberi arayın. İngilizce olarak sunulur. Bebek arabasıyla erişilebilir. Evcil hayvan dostu. Ücretsiz rezervasyon, sonunda ne istersen öde.