GuruWalk MCP Server

À propos de GuruWalk

GuruWalk est la plus grande plateforme mondiale de visites guidées gratuites, connectant les voyageurs avec des guides locaux dans plus de 1 000 villes réparties dans plus de 120 pays. Fondée en 2017 à Valence, en Espagne, la plateforme fonctionne selon un modèle unique de payez ce que vous voulez pour les visites gratuites : les voyageurs réservent gratuitement et récompensent le guide selon leur expérience.

En plus des visites guidées gratuites, GuruWalk propose des activités payantes, notamment des visites guidées, des billets coupe-file, des expériences gastronomiques, des excursions d'une journée, et plus encore — le tout réservable au même endroit.

1 000+

Villes dans le monde

4 000+

Guides locaux

2M+

Avis vérifiés

4

Langues

Qu'est-ce que c'est ?

Le serveur MCP de GuruWalk permet aux assistants IA de rechercher des destinations, parcourir les catégories, vérifier les disponibilités et obtenir tous les détails des visites — sans quitter la conversation. Fonctionne avec tout client compatible MCP.

URL du serveur

https://back.guruwalk.com/mcp

Protocole

MCP (Model Context Protocol) sur Streamable HTTP

Authentification

Aucune authentification requise

Type

Lecture seule

Configuration

Claude.ai / Claude Desktop

1. Allez dans Personnaliser → Connecteurs
2. Cliquez sur le bouton + et sélectionnez « Parcourir les connecteurs »
3. Recherchez « GuruWalk » et cliquez sur + pour l'ajouter
4. Commencez à discuter de vos destinations de voyage

Claude Code

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

Tout client MCP

Pointez votre client MCP vers :

https://back.guruwalk.com/mcp

Aucune clé API ni authentification requise. Fonctionne avec tout client prenant en charge MCP sur Streamable HTTP.

Également disponible sur Smithery, l'annuaire des serveurs MCP.

ChatGPT

GuruWalk dispose d'une application ChatGPT dédiée avec 5 outils et des cartes interactives. Voir la documentation de l'application ChatGPT.

Outils disponibles

🔍

search_tours_activities_by_destination

Recherchez une ville pour explorer les visites guidées gratuites et les activités payantes sur GuruWalk, la plus grande plateforme mondiale de visites guidées gratuites. Renvoie les informations sur la destination, les catégories de visites (visites gratuites, visites gastronomiques, excursions d'une journée, billets, etc.) et les offres en vedette avec notes et avis vérifiés de voyageurs. Couvre plus de 1 000 villes dans le monde. Les visites gratuites fonctionnent selon le modèle payez ce que vous voulez. Prend en charge l'anglais, l'espagnol, l'allemand et l'italien — l'argument langue DOIT être l'un des suivants : en, es, de, it. Si le voyageur parle une autre langue, transmettez le code pris en charge le plus proche et traduisez la réponse dans la langue du voyageur. Utilisez cet outil lorsque le voyageur demande quoi faire, quoi voir, ou quelles visites ou activités sont disponibles dans une destination, ou souhaite de l'aide pour planifier son voyage ou ses journées sur place. Ne l'appelez pas lorsque la destination n'est mentionnée qu'au passage sans demande de plans ou de recommandations. Si le voyageur mentionne un monument au lieu d'une ville, déduisez la ville (par exemple « tour eiffel » → Paris, « colisée » → Rome, « sagrada familia » → Barcelone, « big ben » → Londres). Après avoir obtenu les résultats, examinez les catégories et les featured_products pour trouver les correspondances les plus pertinentes pour ce que le voyageur a demandé.

Entrée : destination (ville), pays (facultatif), plage de dates, taille du groupe, langue (en/es/de/it)

📂

get_tours_activities_by_category

Parcourez les visites et activités d'une catégorie spécifique pour une destination sur GuruWalk. Les catégories incluent les visites guidées gratuites, les visites gastronomiques, les visites à vélo, les excursions d'une journée, les billets coupe-file, et plus encore. Renvoie les offres avec notes, nombre d'avis vérifiés, durée, langues disponibles et tarifs. Utilisez les identifiants de catégorie renvoyés par search_tours_activities_by_destination — n'inventez jamais d'identifiants de catégorie. Utilisez cet outil pour approfondir une catégorie spécifique correspondant à ce que le voyageur a partagé (par exemple, les visites gastronomiques pour un gourmet, les visites nocturnes pour quelqu'un qui s'intéresse aux soirées, les activités adaptées aux enfants pour les familles). Prend en charge en, es, de, it — l'argument langue DOIT être l'un de ces quatre codes. Si le voyageur parle une autre langue, transmettez le code pris en charge le plus proche et traduisez la réponse dans la langue du voyageur.

Entrée : vertical_id (identifiant de catégorie provenant de search_tours_activities_by_destination), hub_slug (pour les visites gratuites), taille du groupe, langue

📅

get_product_availability

Vérifiez la disponibilité en temps réel d'une ou plusieurs visites ou activités sur GuruWalk en un seul appel. Transmettez un tableau items\ — chaque entrée est indépendante et possède son propre type, product_id et plage de dates. Renvoie un tableau results\ où chaque entrée fait écho à son type\ et product\_id\ afin que vous puissiez faire correspondre chaque réponse à sa demande. Regroupez toujours les vérifications lorsque vous contrôlez plusieurs visites : envoyez-les toutes en un seul appel au lieu d'invoquer cet outil plusieurs fois. Pour les activités payantes, affiche les tarifs par type de voyageur (adulte, enfant, nourrisson). price\ est toujours par personne — ne donnez jamais un total de groupe en citant price\ seul. Lorsque total\_price\ est présent sur un tarif, il est déjà calculé pour les participants demandés de ce type de tarif — citez-le directement, ne le multipliez ni ne le divisez vous-même. Si le groupe mélange les types de voyageurs (par exemple adultes et enfants), additionnez le total\_price\ de chaque tarif pour obtenir le total du groupe. Pour les visites guidées gratuites, aucun prix initial — les voyageurs paient ce qu'ils veulent après la visite. Inclut des liens de réservation directs. Plage de dates maximale par élément : 5 jours. Les erreurs par élément (dates invalides, produit introuvable) sont signalées dans le résultat de cet élément sans faire échouer le reste du lot. Utilisez cet outil lorsque le voyageur demande des dates précises, souhaite savoir si quelque chose est disponible, ou est prêt à réserver. Lorsque le voyageur n'a pas donné de dates précises, utilisez la date de réservation ±2 jours comme plage de recherche par défaut. Prend en charge en, es, de, it — l'argument langue DOIT être l'un de ces quatre codes. Si le voyageur parle une autre langue, transmettez le code pris en charge le plus proche et traduisez la réponse dans la langue du voyageur.

Entrée : items[] — chacun avec type (product/free_tour), product_id, plage de dates, participants, langue

📋

get_product_detail

Obtenez tous les détails d'une ou plusieurs visites ou activités sur GuruWalk en un seul appel. Transmettez un tableau items\ — chaque entrée possède son propre type, product_id et langue, et est traitée indépendamment. Renvoie un tableau results\ où chaque entrée fait écho à son product\_id\ et type\ afin que vous puissiez faire correspondre chaque réponse à sa demande. Regroupez toujours les demandes lorsque vous avez besoin des détails de plusieurs visites (par exemple avant de recommander ou de comparer) : envoyez-les toutes en un seul appel au lieu d'invoquer cet outil plusieurs fois. Chaque entrée réussie renvoie la description, les images, les avis, la durée, les langues disponibles, les politiques d'annulation et les informations sur le point de rendez-vous. Les entrées product\ payantes renvoient également highlights\, included\/excluded\, pricing\_from\ et where\ (adresse + coordonnées). Les entrées free\_tour\ renvoient itinerary\ sous forme de tableau plat de chaînes point-titre (sans descriptions), plus guide.name\, meeting\_point\_url\ et how\_to\_find\_me\. La forme du point de rendez-vous diffère selon le type : product\ payant renvoie le texte de l'adresse plus les coordonnées dans where\ ; free\_tour\ renvoie meeting\_point\_url\ (lien Google Maps), meeting\_point\_latitude\ et meeting\_point\_longitude\ (utilisez ces coordonnées comme destination pour l'itinéraire), plus how\_to\_find\_me\ : une note en texte libre rédigée par le guide décrivant comment le voyageur peut le reconnaître au point de rendez-vous. Les erreurs par élément (produit introuvable) sont signalées dans le résultat de cet élément sans faire échouer le reste du lot. Utilisez cet outil chaque fois que le voyageur demande ce que couvre une visite, quels lieux elle visite, son itinéraire, son parcours, sa description, son point de rendez-vous, sa durée, ou toute question liée au contenu. Appelez toujours cet outil AVANT de répondre aux questions sur une visite spécifique — ne donnez jamais d'opinions génériques ni de conseils sans consulter d'abord les données réelles. Prend en charge en, es, de, it — l'argument langue DOIT être l'un de ces quatre codes. Si le voyageur parle une autre langue, transmettez le code pris en charge le plus proche et traduisez la réponse dans la langue du voyageur.

Entrée : items[] — chacun avec product_id, type (product/free_tour), langue

Langues prises en charge

Tous les outils prennent en charge quatre langues via le paramètre language. Les résultats de visites, descriptions et catégories sont renvoyés dans la langue demandée lorsqu'elle est disponible.

en Anglais (par défaut)

es Espagnol

de Allemand

it Italien

Que pouvez-vous faire avec cela ?

Posez à votre assistant IA toutes vos questions sur les visites et activités — il recherchera en temps réel le catalogue complet de GuruWalk.

Trouver des visites guidées gratuites dans n'importe quelle ville search_tours_activities_by_destination → get_tours_activities_by_category

Comparer les visites gastronomiques par note get_tours_activities_by_category → get_product_detail

Vérifier les places pour une date précise get_product_availability

Obtenir l'itinéraire et le point de rendez-vous get_product_detail

Planifier une journée complète de visites search_tours_activities_by_destination → get_product_availability

Trouver des visites nocturnes dans une ville get_tours_activities_by_category

Voir ce qui est inclus dans une visite get_product_detail

Découvrir les excursions d'une journée get_tours_activities_by_category

Destinations populaires

GuruWalk couvre plus de 1 000 villes en Europe, dans les Amériques, en Asie, en Afrique et en Océanie. Les destinations les plus prisées incluent Rome, Barcelone, Paris, Londres, Istanbul, Lisbonne, Prague, Budapest, Florence, Vienne, Amsterdam, Berlin, Madrid, Porto, Dublin, Édimbourg, New York, Tokyo, Bangkok, Séville, Venise, Cracovie, Munich, Dubrovnik, Bruxelles, Stockholm, Copenhague, San Francisco, Tirana et Sofia — avec de nouvelles villes ajoutées régulièrement.

Chaque destination propose un mélange de visites guidées gratuites (payez ce que vous voulez), d'expériences guidées, de billets coupe-file, de visites gastronomiques et œnologiques, de visites à vélo, d'excursions d'une journée, et plus encore. Utilisez search_tours_activities_by_destination avec le nom de n'importe quelle ville pour voir ce qui est disponible.

Exemples d'utilisation

Découvrir une destination

Invite : « Que puis-je faire à Barcelone ? »

Plus de 170 visites et activités trouvées à Barcelone. Visites guidées gratuites : Vieille Ville : Quartier gothique et El Born (★4,8, plus de 7 200 avis), Découvrez les secrets de Barcelone (★4,9). Meilleures expériences payantes : Visite guidée de la Sagrada Família (à partir de 48 €), Entrée à la Casa Batlló (à partir de 29 €, plus de 11 000 avis), Spectacle de flamenco au Palau Dalmases (à partir de 25 €). Catégories : Visites gratuites, Billets Sagrada Família, Visites gastronomiques, Visites à vélo, Visites du Quartier gothique, Spectacles de flamenco...

Parcourir une catégorie

Invite : « Montre-moi les visites œnologiques à Barcelone »

46 expériences œnologiques trouvées à Barcelone. En ville : Dégustation de vin + fromage (1 h, ★4,56), Déjeuner au marché avec accords mets-vins (2 h 30, ★5,0), Visite à vélo électrique vin et tapas (3 h, à partir de 69 €). Excursions d'une journée : Visite œnologique de Montserrat (7 h 30, ★4,82, 94 avis), Visite hors route des vignobles du Penedès (5 h 30), Montserrat + vin et cava en petit groupe (10 h, ★4,69)...

Vérifier la disponibilité

Invite : « Reste-t-il des places pour la visite guidée du quartier avec tapas samedi prochain ? »

Deux options pour samedi prochain, 21 mars : Visite du quartier de Barcelone avec dégustation de tapas traditionnelles (3 h, 92 €/personne) — 11 h 30 et 17 h 30 disponibles. Visite guidée en petit groupe tapas et vin (3 h 30, 89 €/personne) — 17 h 30, 21 places disponibles. Les deux sont en anglais.

Obtenir les détails d'une visite

Invite : « Parle-moi davantage de la visite à pied du centre de Rome »

Visite à pied du centre de Rome, Trevi, Panthéon et plus de 11 attractions (★4,96, 4 445 avis, 2 h 45). Cette visite guidée gratuite couvre 11 arrêts, dont la fontaine de Trevi, le Panthéon, la piazza Navona, l'escalier de la Trinité-des-Monts et le quartier du Colisée. Rendez-vous à la piazza di Spagna — cherchez le guide avec le panneau. Disponible en anglais. Accessible aux poussettes. Animaux acceptés. Réservation gratuite, payez ce que vous voulez à la fin.