com.guruwalk/mcp

Official4 tools

GuruWalk

Free walking tours & activities in 200+ cities. Browse, check availability, and get tour details.

Browse and check availability for free walking tours and activities across 200+ cities.

Captured live from the server via tools/list.

discover_destination

Search a city to explore free walking tours and paid activities on GuruWalk, the world's largest free walking tour platform. Returns destination info, tour categories (free tours, food tours, day trips, tickets, and more), and featured listings with ratings and verified traveler reviews. Covers 200+ cities worldwide. Free tours operate on a pay-what-you-want model. Supports English, Spanish, German, and Italian. Use this tool when you know the traveler's destination and the conversation has reached the point of recommending experiences. Do NOT call it just because a destination is mentioned — first understand what the traveler is looking for. If the traveler mentions a landmark instead of a city, infer the city (e.g. 'eiffel tower' → Paris, 'colosseum' → Rome, 'sagrada familia' → Barcelona, 'big ben' → London). After getting results, review the categories and featured_products to find the most relevant matches for what the traveler asked about.

Parameters (9)

destinationstringrequired
City name, e.g. 'Rome'
languagestring
Language code: en, es, de, it
pageinteger
Page number for featured products (default: 1)
start_datestring
Only show tours available from this date (YYYY-MM-DD). Use the traveler's booking date minus 2 days if no specific date was mentioned.
end_datestring
Only show tours available until this date (YYYY-MM-DD). Use the traveler's booking date plus 2 days if no specific date was mentioned.
textstring
Optional text filter. When provided, featured_products are narrowed to paid products whose name matches the text (MATCH AGAINST, all tokens must appear as prefix, tokens of <3 chars ignored), and free tours are automatically excluded (their legacy search doesn't support text filtering). Use when the traveler names a specific attraction ('Casa Batlló', 'Sagrada Familia') or a themed phrase ('food tour'). Leave empty for the full hub listing including free tours.
countrystring
Country the destination is in (name in any language or ISO code), to disambiguate cities that share a name across countries (e.g. Bayonne in France vs Bayona in Spain). Provide it whenever the country is clear from context. If the country has no matching city, the search returns no destination — a reliable signal that there's no coverage there.
how_many_adultsinteger
Number of adults in the group. Pass it (together with how_many_children) when the traveler tells you how many people are going, so only free tours that admit that group size are returned — especially useful for large groups. Whether children count toward capacity is decided per tour.
how_many_childreninteger
Number of children in the group. Pass together with how_many_adults when the group includes children — whether children count toward capacity is decided per tour.

browse_category

Browse tours and activities within a specific category for a destination on GuruWalk. Categories include free walking tours, food tours, bike tours, day trips, skip-the-line tickets, and more. Returns listings with ratings, verified review counts, duration, available languages, and pricing. Use the category IDs returned by discover_destination — never invent category IDs. Use this tool to dive deeper into a specific category that matches what the traveler has shared (e.g. food tours for a foodie, night tours for someone asking about evenings, kid-friendly activities for families).

Parameters (6)

vertical_idstringrequired
The ID of the vertical/category to browse. Use 'free-tour' for the free tours category.
hub_slugstring
Hub slug of the destination (required when vertical_id is 'free-tour')
languagestring
Language code (en, es, de, it)
pageinteger
Page number (default: 1)
how_many_adultsinteger
Number of adults in the group. Pass it (together with how_many_children) when the traveler tells you how many people are going, so the free-tour results are narrowed to tours that admit that group size — especially useful for large groups. Whether children count toward capacity is decided per tour.
how_many_childreninteger
Number of children in the group. Pass together with how_many_adults when the group includes children — whether children count toward capacity is decided per tour.

check_availability

Check real-time availability for one or more tours or activities on GuruWalk in a single call. Pass an `items` array — each entry is independent and has its own type, product_id and date range. Returns a `results` array where every entry echoes its `type` and `product_id` so you can match each response to its request. Always batch when checking multiple tours: send them all in one call instead of invoking this tool several times. For paid activities, shows rates by traveler type (adult, child, infant). For free walking tours, no upfront price — travelers pay what they want after the tour. Includes direct booking links. Maximum date range per item: 5 days. Per-item errors (invalid dates, product not found) are reported inside that item's result without failing the rest of the batch. Use this tool when the traveler asks about specific dates, wants to know if something is available, or is ready to book. When the traveler hasn't given specific dates, use the booking date ±2 days as the default search range.

Parameters (1)

itemsarrayrequired
One or more tours/products to check (max 20 per call). Use a single entry for one tour, or many entries to batch multiple tours in the same call.

get_product_detail

Get the full detail of one or more tours or activities on GuruWalk in a single call. Pass an `items` array — each entry has its own type, product_id and language, and is processed independently. Returns a `results` array where every entry echoes its `product_id` and `type` so you can match each response to its request. Always batch when you need details for several tours (e.g. before recommending or comparing them): send them all in one call instead of invoking this tool several times. Each successful entry returns description, images, reviews, duration, available languages, cancellation policies, and meeting point info. Paid `product` entries also return `highlights`, `included`/`excluded`, `pricing_from`, and `where` (address + coordinates). `free_tour` entries return `itinerary` as a flat array of point-title strings (no descriptions), plus `guide.name`, `meeting_point_url`, and `how_to_find_me`. Meeting point shape differs by type: paid `product` returns the address text plus coordinates in `where`; `free_tour` returns `meeting_point_url` (Google Maps link), `meeting_point_latitude` and `meeting_point_longitude` (use these coords as destination for routing), plus `how_to_find_me`: a free-text note written by the guide describing how the traveler can recognize them at the meeting point. Per-item errors (product not found) are reported inside that item's result without failing the rest of the batch. Use this tool whenever the traveler asks what a tour covers, which places it visits, its itinerary, route, description, meeting point, duration, or any content-related question. Always call this tool BEFORE answering questions about a specific tour — never give generic opinions or advice without consulting the real data first.

Parameters (1)

itemsarrayrequired
One or more tours/products to fetch details for (max 10 per call). Use a single entry for one tour, or many entries to batch multiple tours in the same call.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://back.guruwalk.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.