GuruWalk

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 1,000+ cities worldwide. Free tours operate on a pay-what-you-want model. Supports English, Spanish, German, and Italian (en, es, de, it); any other value falls back to English. Pass the traveler's language code anyway and translate the answer into their language. Use this tool when the traveler asks what to do, what to see, or what tours or activities are available in a destination, or wants help planning their trip or days there. Do not call it when the destination is only mentioned in passing with no request for plans or recommendations. 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. Each featured product includes a booking_url — when recommending tours, share it so the traveler can open the tour to see details, prices and book.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "City name, e.g. 'Rome'"
    },
    "language": {
      "type": "string",
      "description": "Language code. Supported: en, es, de, it; any other value falls back to English. Defaults to en."
    },
    "page": {
      "type": "integer",
      "description": "Page number for featured products (default: 1)",
      "default": 1
    },
    "start_date": {
      "type": "string",
      "description": "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_date": {
      "type": "string",
      "description": "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."
    },
    "text": {
      "type": "string",
      "description": "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."
    },
    "country": {
      "type": "string",
      "description": "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_adults": {
      "type": "integer",
      "description": "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_children": {
      "type": "integer",
      "description": "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."
    }
  },
  "required": [
    "destination"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "coverage": {
      "type": "string",
      "enum": [
        "none"
      ],
      "description": "Present only when GuruWalk has no tours or activities in the destination."
    },
    "destination": {
      "type": "string",
      "description": "Echo of the requested destination when coverage is none."
    },
    "message": {
      "type": "string"
    },
    "place": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        },
        "has_free_tours": {
          "type": "boolean"
        },
        "url": {
          "type": "string"
        }
      }
    },
    "pagination": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer"
        },
        "per_page": {
          "type": "integer"
        },
        "total_count": {
          "type": "integer"
        }
      }
    },
    "categories": {
      "type": "array",
      "description": "Tour categories available in the destination; pass a category `id` as vertical_id to browse it.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "integer"
            ],
            "description": "'free-tour' for the free tours category, numeric for verticals."
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "hub_slug": {
            "type": "string",
            "description": "Present on the free tours category."
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "url"
        ]
      }
    },
    "featured_products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "rating": {
            "type": [
              "number",
              "string"
            ]
          },
          "reviews_count": {
            "type": "integer"
          },
          "duration": {
            "type": [
              "integer",
              "string"
            ],
            "description": "Minutes for paid activities; free tours may report a label."
          },
          "pricing_from": {
            "type": "object",
            "properties": {
              "retail": {
                "type": "number"
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "booking_url": {
            "type": "string",
            "description": "Share it with the traveler exactly as returned — never rewrite the domain or drop query parameters, they carry required attribution."
          },
          "source": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "id"
        ]
      }
    },
    "tip": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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 search_tours_activities_by_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). Supports en, es, de, it; any other value falls back to English. Pass the traveler's language code anyway and translate the answer into their language. Each product includes a booking_url — when recommending tours, share it so the traveler can open the tour to see details, prices and book.

{
  "type": "object",
  "properties": {
    "vertical_id": {
      "type": "string",
      "description": "The ID of the vertical/category to browse. Use 'free-tour' for the free tours category."
    },
    "hub_slug": {
      "type": "string",
      "description": "Hub slug of the destination (required when vertical_id is 'free-tour')"
    },
    "language": {
      "type": "string",
      "description": "Language code. Supported: en, es, de, it; any other value falls back to English. Defaults to en."
    },
    "page": {
      "type": "integer",
      "description": "Page number (default: 1)",
      "default": 1
    },
    "how_many_adults": {
      "type": "integer",
      "description": "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_children": {
      "type": "integer",
      "description": "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."
    }
  },
  "required": [
    "vertical_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "place": {
          "type": [
            "string",
            "null"
          ],
          "description": "Destination name; absent for the free tours category."
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name",
        "url"
      ]
    },
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "id": {
            "type": "integer"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Null when the product lacks a translation for the requested language."
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "rating": {
            "type": [
              "number",
              "string",
              "null"
            ]
          },
          "reviews_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "duration": {
            "type": [
              "integer",
              "string",
              "null"
            ],
            "description": "Minutes for paid activities; free tours may report a label."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "pricing_from": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "retail": {
                "type": "number"
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "booking_url": {
            "type": "string",
            "description": "Share it with the traveler exactly as returned — never rewrite the domain or drop query parameters, they carry required attribution."
          },
          "source": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "id",
          "booking_url"
        ]
      }
    },
    "pagination": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer"
        },
        "per_page": {
          "type": "integer"
        },
        "total_count": {
          "type": "integer"
        }
      }
    },
    "tip": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    }
  },
  "required": [
    "category",
    "products",
    "pagination"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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. Check the tours the traveler has already chosen — this is not a catalog browsing tool, so don't run it over search results to explore what's on offer. For paid activities, shows rates by traveler type (adult, child, infant). `price` is always per person — never state a group total by quoting `price` alone. When `total_price` is present on a rate, it's already computed for the participants you requested of that rate's type — quote it directly, don't multiply or divide it yourself. If the group mixes traveler types (e.g. adults and children), sum each rate's `total_price` for the full group total. For free walking tours, no upfront price — travelers pay what they want after the tour. For paid activities, an event's `languages` lists the languages that session runs in (e.g. audioguide languages), and sessions differing only in language are merged into a single event; free walking tour events each carry a single `language` instead. `booking_url` is returned once per item, not per event; for paid activities you can add a `date=YYYY-MM-DD` query parameter to preselect a day. 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. Supports en, es, de, it; any other value falls back to English. Pass the traveler's language code anyway and translate the answer into their language.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "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.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Type of listing: 'product' for paid activities, 'free_tour' for free walking tours. Use the type returned by search_tours_activities_by_destination or get_tours_activities_by_category.",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "product_id": {
            "type": "string",
            "description": "The product or tour ID to check availability for."
          },
          "from_date": {
            "type": "string",
            "description": "Start date in YYYY-MM-DD format."
          },
          "to_date": {
            "type": "string",
            "description": "End date in YYYY-MM-DD format. Defaults to from_date if omitted. Maximum 5-day range per item."
          },
          "language": {
            "type": "string",
            "description": "Language code. Supported: en, es, de, it; any other value falls back to English. Defaults to en."
          },
          "participants": {
            "type": "array",
            "description": "Traveler breakdown by type. REQUIRED for paid activities (type: 'product') to get accurate per-person pricing — always pass the actual group the caller confirmed (e.g. 2 adults, 1 child). Ignored for free_tour. If the traveler has not yet confirmed group size, omit this field and a default of 2 adults will be used as a fallback. Valid types: adult, youth, child, infant, senior, student, eu_citizen, military, eu_citizen_student.",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "Traveler type.",
                  "enum": [
                    "adult",
                    "youth",
                    "child",
                    "infant",
                    "senior",
                    "student",
                    "eu_citizen",
                    "military",
                    "eu_citizen_student"
                  ]
                },
                "quantity": {
                  "type": "integer",
                  "description": "Number of travelers of this type.",
                  "minimum": 1
                }
              },
              "required": [
                "type",
                "quantity"
              ]
            }
          }
        },
        "required": [
          "type",
          "product_id",
          "from_date"
        ]
      }
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "One entry per requested item, in request order, echoing its type and product_id.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "product_id": {
            "type": "string"
          },
          "from_date": {
            "type": "string",
            "description": "YYYY-MM-DD."
          },
          "to_date": {
            "type": "string",
            "description": "YYYY-MM-DD."
          },
          "booking_url": {
            "type": "string",
            "description": "Booking link for this item. Share it with the traveler exactly as returned — never rewrite the domain or drop query parameters, they carry required attribution."
          },
          "events": {
            "type": "array",
            "description": "Available sessions. Paid activity events carry `languages` and `pricing`; free walking tour events carry a single `language` and `last_seats`.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "YYYY-MM-DD."
                },
                "name": {
                  "type": "string",
                  "description": "Session or ticket option name, when the provider names sessions."
                },
                "start_time": {
                  "type": "string"
                },
                "available_seats": {
                  "type": "integer"
                },
                "available": {
                  "type": "boolean"
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Languages this session runs in; sessions differing only in language are merged."
                },
                "language": {
                  "type": "string",
                  "description": "Free walking tours only."
                },
                "last_seats": {
                  "type": "boolean",
                  "description": "Free walking tours only: true when few seats remain."
                },
                "pricing": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "rates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "price": {
                            "type": [
                              "number",
                              "null"
                            ],
                            "description": "Per-person price."
                          },
                          "min_quantity": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "max_quantity": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "total_price": {
                            "type": "number",
                            "description": "Total already computed for the requested participants of this rate's type."
                          }
                        }
                      }
                    }
                  }
                }
              },
              "required": [
                "date"
              ]
            }
          },
          "error": {
            "type": "string",
            "description": "Per-item failure; other items in the batch are unaffected."
          }
        },
        "required": [
          "type",
          "product_id",
          "from_date",
          "to_date"
        ]
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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`. Both types return `meeting_point_url` (Google Maps link) whenever the meeting point has coordinates. For a `free_tour` that is the meeting point. For a paid `product` it is the reference point published on the listing: useful to orient a traveler who has not booked yet, but the operative meeting point of a purchased activity — with the supplier's own instructions — is the one in its voucher. Offer it as a reference, never as the confirmed meeting point of a booking. Paid `product` also returns the address text and coordinates in `where`; `free_tour` also returns `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. For the meeting point of a paid activity the traveler has already booked, the booking's voucher comes first; fall back to this tool only when that voucher has no meeting point yet, and say then that this is the point published on the listing and that the definitive one arrives with the voucher. Always call this tool BEFORE answering questions about a specific tour — never give generic opinions or advice without consulting the real data first. Supports en, es, de, it; any other value falls back to English. Pass the traveler's language code anyway and translate the answer into their language. Each result includes the tour's url — when recommending or confirming a tour, share it so the traveler can open it to book.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "description": "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.",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "integer",
            "description": "The numeric ID of the product or free tour."
          },
          "type": {
            "type": "string",
            "description": "Type of listing: 'product' for paid activities, 'free_tour' for free walking tours.",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "language": {
            "type": "string",
            "description": "Language code. Supported: en, es, de, it; any other value falls back to English. Defaults to en."
          }
        },
        "required": [
          "product_id",
          "type"
        ]
      }
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "One entry per requested item, in request order, echoing its product_id and type.",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "integer"
          },
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "error": {
            "type": "string",
            "description": "Per-item failure; other items in the batch are unaffected."
          },
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "description_html": {
            "type": "string"
          },
          "subtitle_html": {
            "type": "string",
            "description": "Paid activities only."
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "highlights": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Paid activities only."
          },
          "included": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Paid activities only."
          },
          "excluded": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Paid activities only."
          },
          "other_info": {
            "type": "array",
            "description": "Paid activities only."
          },
          "meeting_point_html": {
            "type": "string",
            "description": "Paid activities only."
          },
          "instructions_html": {
            "type": "string",
            "description": "Paid activities only."
          },
          "special_notes_html": {
            "type": "string",
            "description": "Paid activities only."
          },
          "cancellation_policies": {
            "type": "array",
            "description": "Paid activities only."
          },
          "available_languages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "live_guide_languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Paid activities only."
          },
          "audio_guide_languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Paid activities only."
          },
          "when_starting_time": {
            "type": "string",
            "description": "Paid activities only."
          },
          "duration_minutes": {
            "type": "object",
            "properties": {
              "from": {
                "type": "integer"
              },
              "to": {
                "type": "integer"
              }
            },
            "description": "Paid activities only."
          },
          "duration": {
            "type": [
              "string",
              "integer"
            ],
            "description": "Free tours only."
          },
          "where": {
            "type": "object",
            "description": "Paid activities only: meeting point address and coordinates.",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "address_html": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "latitude": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "longitude": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "meeting_point_url": {
            "type": "string",
            "description": "Google Maps link to the meeting point, returned for both paid activities and free tours. Built from the meeting point coordinates, so it is absent when they are unknown."
          },
          "meeting_point_latitude": {
            "type": "number",
            "description": "Free tours only."
          },
          "meeting_point_longitude": {
            "type": "number",
            "description": "Free tours only."
          },
          "how_to_find_me": {
            "type": "string",
            "description": "Free tours only: guide's note on how to recognize them at the meeting point."
          },
          "itinerary": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Free tours only: point titles."
          },
          "reviews": {
            "type": "object",
            "properties": {
              "count": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "rating": {
                "type": [
                  "number",
                  "string",
                  "null"
                ]
              }
            }
          },
          "pricing_from": {
            "type": "object",
            "description": "Paid activities only.",
            "properties": {
              "retail": {
                "type": "number"
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "place": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "slug": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "timezone": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Paid activities only."
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Free tours only."
              }
            }
          },
          "features": {
            "type": "object",
            "description": "Free tours only.",
            "properties": {
              "accessible": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "pets_allowed": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "large_groups_allowed": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "large_groups_limit": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "guide": {
            "type": "object",
            "description": "Free tours only.",
            "properties": {
              "name": {
                "type": "string"
              }
            }
          },
          "url": {
            "type": "string",
            "description": "Tour page URL. Share it with the traveler exactly as returned — never rewrite the domain or drop query parameters, they carry required attribution."
          },
          "source": {
            "type": "string"
          },
          "attribution": {
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "type"
        ]
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Present a selection of tours or activities to the traveler as a visual list of cards (photo, rating, price, booking button) rendered inline in the conversation. Showing cards is the default way to present tours to the traveler: whenever your reply features specific tours (recommendations, a shortlist, availability results), call this tool alongside your text instead of waiting to be asked. Don't re-render a selection you already showed unless it changed. Call it AFTER finding tours with the search tools — it is a presentation tool, not a search tool. If you already checked availability with get_product_availability, you can pass each item's sessions (date and start time) and the cards will highlight them with booking links preselecting the date. For clients without UI support the same data is returned as structured text.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "description": "The tours to display, in the order they should appear. Only the first 12 items are rendered; extras are dropped.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ],
            "description": "Type of listing, as returned by the search tools."
          },
          "product_id": {
            "type": "integer",
            "description": "The numeric ID of the product or free tour."
          },
          "events": {
            "type": "array",
            "description": "Optional: available sessions for this item as returned by get_product_availability — pass them only when you actually checked availability, never invent dates, and skip sessions reported as unavailable or sold out. The card highlights up to 3 of them with booking links preselecting the date.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "YYYY-MM-DD."
                },
                "start_time": {
                  "type": "string",
                  "description": "HH:MM, when the session has a start time."
                }
              },
              "required": [
                "date"
              ]
            }
          }
        },
        "required": [
          "type",
          "product_id"
        ]
      }
    },
    "language": {
      "type": "string",
      "description": "Language code. Supported: en, es, de, it; any other value falls back to English. Defaults to en."
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "Normalized language of the request; the widget localizes its labels with it."
    },
    "tours": {
      "type": "array",
      "description": "One card per resolvable item, in request order; unresolvable items are skipped.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "product",
              "free_tour"
            ]
          },
          "id": {
            "type": "integer"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": "string"
          },
          "rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "reviews_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price": {
            "type": "object",
            "description": "Absent for free walking tours (pay-what-you-want).",
            "properties": {
              "amount": {
                "type": "number"
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "events": {
            "type": "array",
            "description": "Sessions highlighted on the card, present when the request included them.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "YYYY-MM-DD."
                },
                "start_time": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "description": "Booking link preselecting this date. Share it with the traveler exactly as returned."
                }
              },
              "required": [
                "date",
                "url"
              ]
            }
          },
          "more_events": {
            "type": "integer",
            "description": "How many additional valid sessions were passed but not rendered on the card."
          },
          "source": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "Booking link. Share it with the traveler exactly as returned — never rewrite the domain or drop query parameters, they carry required attribution."
          }
        },
        "required": [
          "type",
          "id",
          "url"
        ]
      }
    },
    "attribution": {
      "type": "string"
    },
    "notice": {
      "type": "string",
      "description": "Present only when the request exceeded the item limit and was truncated."
    }
  },
  "required": [
    "tours"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns an official GuruWalk support guide for a specific traveler-support topic. GuruWalk is a platform for free walking tours and paid activities; these guides are GuruWalk's own source of truth on how bookings, cancellations, account settings and contacting guides actually work, including current policies and the exact URLs travelers should use. These guides apply only to bookings and accounts on guruwalk.com. Available topics: - account_settings: The traveler wants to manage their GuruWalk account: edit their details (name, surname, phone, city, password), change their email, stop receiving emails / unsubscribe, or delete their account; or they can't access their account. These are concrete steps you shouldn't improvise: consult this before answering. - contact_guru: The traveler wants to contact or coordinate something with the guide of their GuruWalk booking, or thinks they are talking directly to the guide: they can't find them at the meeting point, the guide didn't show up, they're running late, they treat you as if you were the guide, ask for the tour photos, or ask about bringing a pet or paying the guide, or have a question only the guide can answer. - free_tour_modification: The traveler wants to modify or reschedule their GuruWalk free tour — change the day, time, language or number of people — or asks how to do it. - group_booking: The traveler wants to book or extend a GuruWalk booking for a group (they usually say how many; treat it as a large group from around 6 people), asks how to book for many people, can't book for the whole group, sees a large-group notice or is asked for a card or payment for the group, or had a booking cancelled as "group or duplicate". The rules aren't intuitive; consult this before advising. - paid_cancellation: The traveler wants to cancel or change a paid activity booked on GuruWalk, asks about a refund, or can't cancel from their account. Call this when the traveler raises a support topic covered above. Pass the exact topic; the guide content is returned.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "The exact topic of the guide to load, as listed in this tool's description."
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The full guide content."
    }
  },
  "required": [
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}