GuruWalk MCP Server

Sobre o GuruWalk

O GuruWalk é a maior plataforma mundial de free walking tours, conectando viajantes a guias locais em mais de 1.000 cidades em mais de 120 países. Fundada em 2017 em Valência, Espanha, a plataforma opera com um modelo único de pague o quanto quiser para tours gratuitos: os viajantes reservam de graça e dão gorjeta ao guia com base na experiência.

Além dos free walking tours, o GuruWalk oferece atividades pagas, incluindo tours guiados, ingressos sem fila, experiências gastronômicas, passeios de um dia e muito mais — tudo reservável em um só lugar.

1.000+

Cidades no mundo

4.000+

Guias locais

2M+

Avaliações verificadas

4

Idiomas

O que é isso?

O servidor MCP do GuruWalk permite que assistentes de IA pesquisem destinos, naveguem por categorias, verifiquem disponibilidade e obtenham detalhes completos dos tours — tudo sem sair da conversa. Funciona com qualquer cliente compatível com MCP.

URL do servidor

https://back.guruwalk.com/mcp

Protocolo

MCP (Model Context Protocol) via Streamable HTTP

Autenticação

Nenhuma autenticação necessária

Tipo

Somente leitura

Configuração

Claude.ai / Claude Desktop

1. Vá em Personalizar → Conectores
2. Clique no botão + e selecione "Procurar conectores"
3. Pesquise por "GuruWalk" e clique em + para adicionar
4. Comece a conversar sobre destinos de viagem

Claude Code

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

Qualquer Cliente MCP

Aponte seu cliente MCP para:

https://back.guruwalk.com/mcp

Nenhuma chave de API ou autenticação necessária. Funciona com qualquer cliente que suporte MCP via Streamable HTTP.

Também disponível no Smithery, o registro de servidores MCP.

ChatGPT

O GuruWalk tem um aplicativo dedicado para ChatGPT com 5 ferramentas e cartões interativos. Veja a documentação do aplicativo ChatGPT.

Ferramentas Disponíveis

🔍

search_tours_activities_by_destination

Pesquise uma cidade para explorar free walking tours e atividades pagas no GuruWalk, a maior plataforma mundial de free walking tours. Retorna informações do destino, categorias de tours (free tours, tours gastronômicos, passeios de um dia, ingressos e mais) e listagens em destaque com avaliações e comentários verificados de viajantes. Abrange mais de 1.000 cidades no mundo. Os free tours operam no modelo pague o quanto quiser. Suporta inglês, espanhol, alemão e italiano — o argumento de idioma DEVE ser um de en, es, de, it. Se o viajante falar outro idioma, passe o código suportado mais próximo e traduza a resposta para o idioma do viajante. Use esta ferramenta quando o viajante perguntar o que fazer, o que ver, ou quais tours ou atividades estão disponíveis em um destino, ou quiser ajuda para planejar a viagem ou os dias no local. Não a chame quando o destino for mencionado apenas de passagem, sem pedido de planos ou recomendações. Se o viajante mencionar um ponto turístico em vez de uma cidade, deduza a cidade (ex.: 'torre eiffel' → Paris, 'coliseu' → Roma, 'sagrada familia' → Barcelona, 'big ben' → Londres). Após obter os resultados, revise as categorias e os featured_products para encontrar as correspondências mais relevantes para o que o viajante perguntou.

Entrada: destino (cidade), país (opcional), intervalo de datas, tamanho do grupo, idioma (en/es/de/it)

📂

get_tours_activities_by_category

Navegue por tours e atividades dentro de uma categoria específica para um destino no GuruWalk. As categorias incluem free walking tours, tours gastronômicos, tours de bicicleta, passeios de um dia, ingressos sem fila e mais. Retorna listagens com avaliações, contagem de comentários verificados, duração, idiomas disponíveis e preços. Use os IDs de categoria retornados por search_tours_activities_by_destination — nunca invente IDs de categoria. Use esta ferramenta para aprofundar em uma categoria específica que corresponda ao que o viajante compartilhou (ex.: tours gastronômicos para um amante da culinária, tours noturnos para alguém perguntando sobre a noite, atividades para crianças para famílias). Suporta en, es, de, it — o argumento de idioma DEVE ser um desses quatro códigos. Se o viajante falar outro idioma, passe o código suportado mais próximo e traduza a resposta para o idioma do viajante.

Entrada: vertical_id (ID da categoria de search_tours_activities_by_destination), hub_slug (para free tours), tamanho do grupo, idioma

📅

get_product_availability

Verifique a disponibilidade em tempo real de um ou mais tours ou atividades no GuruWalk em uma única chamada. Passe um array items\ — cada entrada é independente e tem seu próprio tipo, product_id e intervalo de datas. Retorna um array results\ onde cada entrada ecoa seu type\ e product\_id\ para que você possa corresponder cada resposta à sua solicitação. Sempre agrupe ao verificar vários tours: envie todos em uma única chamada em vez de invocar esta ferramenta várias vezes. Para atividades pagas, mostra tarifas por tipo de viajante (adulto, criança, bebê). price\ é sempre por pessoa — nunca declare um total do grupo citando price\ isoladamente. Quando total\_price\ estiver presente em uma tarifa, ele já está calculado para os participantes solicitados daquele tipo de tarifa — cite-o diretamente, não multiplique nem divida por conta própria. Se o grupo misturar tipos de viajantes (ex.: adultos e crianças), some o total\_price\ de cada tarifa para o total do grupo. Para free walking tours, não há preço antecipado — os viajantes pagam o que quiserem após o tour. Inclui links diretos de reserva. Intervalo máximo de datas por item: 5 dias. Erros por item (datas inválidas, produto não encontrado) são relatados dentro do resultado daquele item sem falhar o restante do lote. Use esta ferramenta quando o viajante perguntar sobre datas específicas, quiser saber se algo está disponível ou estiver pronto para reservar. Quando o viajante não tiver dado datas específicas, use a data da reserva ±2 dias como intervalo de pesquisa padrão. Suporta en, es, de, it — o argumento de idioma DEVE ser um desses quatro códigos. Se o viajante falar outro idioma, passe o código suportado mais próximo e traduza a resposta para o idioma do viajante.

Entrada: items[] — cada um com tipo (product/free_tour), product_id, intervalo de datas, participantes, idioma

📋

get_product_detail

Obtenha os detalhes completos de um ou mais tours ou atividades no GuruWalk em uma única chamada. Passe um array items\ — cada entrada tem seu próprio tipo, product_id e idioma, e é processada de forma independente. Retorna um array results\ onde cada entrada ecoa seu product\_id\ e type\ para que você possa corresponder cada resposta à sua solicitação. Sempre agrupe quando precisar de detalhes de vários tours (ex.: antes de recomendar ou comparar): envie todos em uma única chamada em vez de invocar esta ferramenta várias vezes. Cada entrada bem-sucedida retorna descrição, imagens, avaliações, duração, idiomas disponíveis, políticas de cancelamento e informações do ponto de encontro. Entradas pagas de product\ também retornam highlights\, included\/excluded\, pricing\_from\ e where\ (endereço + coordenadas). Entradas de free\_tour\ retornam itinerary\ como um array simples de strings de título de pontos (sem descrições), além de guide.name\, meeting\_point\_url\ e how\_to\_find\_me\. O formato do ponto de encontro difere por tipo: product\ pago retorna o texto do endereço mais coordenadas em where\; free\_tour\ retorna meeting\_point\_url\ (link do Google Maps), meeting\_point\_latitude\ e meeting\_point\_longitude\ (use essas coordenadas como destino para roteamento), além de how\_to\_find\_me\: uma nota em texto livre escrita pelo guia descrevendo como o viajante pode reconhecê-lo no ponto de encontro. Erros por item (produto não encontrado) são relatados dentro do resultado daquele item sem falhar o restante do lote. Use esta ferramenta sempre que o viajante perguntar o que um tour cobre, quais lugares visita, seu itinerário, rota, descrição, ponto de encontro, duração ou qualquer pergunta relacionada a conteúdo. Sempre chame esta ferramenta ANTES de responder perguntas sobre um tour específico — nunca dê opiniões genéricas ou conselhos sem consultar os dados reais primeiro. Suporta en, es, de, it — o argumento de idioma DEVE ser um desses quatro códigos. Se o viajante falar outro idioma, passe o código suportado mais próximo e traduza a resposta para o idioma do viajante.

Entrada: items[] — cada um com product_id, tipo (product/free_tour), idioma

Idiomas Suportados

Todas as ferramentas suportam quatro idiomas por meio do parâmetro language. Resultados de tours, descrições e categorias são retornados no idioma solicitado quando disponível.

en Inglês (padrão)

es Espanhol

de Alemão

it Italiano

O que você pode fazer com isso?

Pergunte ao seu assistente de IA qualquer coisa sobre tours e atividades — ele pesquisará o catálogo completo do GuruWalk em tempo real.

Encontre free walking tours em qualquer cidade search_tours_activities_by_destination → get_tours_activities_by_category

Compare tours gastronômicos por avaliação get_tours_activities_by_category → get_product_detail

Verifique vagas para uma data específica get_product_availability

Obtenha itinerário e ponto de encontro get_product_detail

Planeje um dia inteiro com tours search_tours_activities_by_destination → get_product_availability

Encontre tours noturnos em uma cidade get_tours_activities_by_category

Veja o que está incluído em um tour get_product_detail

Descubra passeios de um dia e excursões get_tours_activities_by_category

Destinos Populares

O GuruWalk cobre mais de 1.000 cidades na Europa, Américas, Ásia, África e Oceania. Os principais destinos incluem Roma, Barcelona, Paris, Londres, Istambul, Lisboa, Praga, Budapeste, Florença, Viena, Amsterdã, Berlim, Madri, Porto, Dublin, Edimburgo, Nova York, Tóquio, Bangkok, Sevilha, Veneza, Cracóvia, Munique, Dubrovnik, Bruxelas, Estocolmo, Copenhague, São Francisco, Tirana e Sófia — com novas cidades adicionadas regularmente.

Cada destino oferece uma combinação de free walking tours (pague o quanto quiser), experiências guiadas, ingressos sem fila, tours de comida e vinho, tours de bicicleta, passeios de um dia e mais. Use search_tours_activities_by_destination com o nome de qualquer cidade para ver o que está disponível.

Exemplos de Uso

Descubra um destino

Prompt: "O que posso fazer em Barcelona?"

Encontrados mais de 170 tours e atividades em Barcelona. Free walking tours: Cidade Velha: Bairro Gótico e El Born (★4,8, mais de 7.200 avaliações), Descubra os Segredos de Barcelona (★4,9). Principais experiências pagas: Tour Guiado pela Sagrada Família (a partir de €48), Entrada na Casa Batlló (a partir de €29, mais de 11.000 avaliações), Show de Flamenco no Palau Dalmases (a partir de €25). Categorias: Free Tours, Ingressos Sagrada Família, Tours Gastronômicos, Tours de Bicicleta, Tours pelo Bairro Gótico, Shows de Flamenco...

Navegue por uma categoria

Prompt: "Mostre-me tours de vinho em Barcelona"

Encontradas 46 experiências de vinho em Barcelona. Na cidade: Degustação de Vinho + Queijo (1h, ★4,56), Almoço no Mercado de Alimentos com Harmonização de Vinhos (2,5h, ★5,0), Tour de e-Bike de Vinho e Tapas (3h, a partir de €69). Passeios de um dia: Tour de Vinho em Montserrat (7,5h, ★4,82, 94 avaliações), Tour Off-Road pelas Vinhas de Penedès (5,5h), Montserrat + Vinho e Cava em Grupo Pequeno (10h, ★4,69)...

Verifique disponibilidade

Prompt: "Ainda há vagas no tour guiado pelo bairro com tapas no próximo sábado?"

Duas opções para o próximo sábado, 21 de março: Tour pelo Bairro de Barcelona com Degustação de Tapas Tradicionais (3h, 92€/pessoa) — 11h30 e 17h30 disponíveis. Tour Guiado de Tapas e Vinho em Grupo Pequeno (3h30, 89€/pessoa) — 17h30, 21 vagas disponíveis. Ambos em inglês.

Obtenha detalhes do tour

Prompt: "Conte-me mais sobre o Walking Tour pelo Centro de Roma"

Walking Tour pelo Centro de Roma, Trevi, Panteão e Mais de 11 Atrações (★4,96, 4.445 avaliações, 2h45). Este free walking tour cobre 11 paradas, incluindo a Fonte de Trevi, o Panteão, a Piazza Navona, a Escadaria Espanhola e a área do Coliseu. Encontro na Piazza di Spagna — procure o guia com a placa. Disponível em inglês. Acessível para carrinhos de bebê. Pet-friendly. Reserve de graça, pague o quanto quiser no final.