GuruWalk MCP Server

Về GuruWalk

GuruWalk là nền tảng tour đi bộ miễn phí lớn nhất thế giới, kết nối du khách với hướng dẫn viên địa phương tại hơn 1.000 thành phố ở hơn 120 quốc gia. Được thành lập vào năm 2017 tại Valencia, Tây Ban Nha, nền tảng này hoạt động theo mô hình trả bao nhiêu tùy bạn độc đáo cho các tour miễn phí: du khách đặt tour miễn phí và tip hướng dẫn viên dựa trên trải nghiệm của mình.

Bên cạnh các tour đi bộ miễn phí, GuruWalk còn cung cấp các hoạt động trả phí bao gồm tour có hướng dẫn, vé ưu tiên không xếp hàng, trải nghiệm ẩm thực, tour trong ngày, và nhiều hơn nữa — tất cả đều có thể đặt tại một nơi.

1.000+

Thành phố trên toàn thế giới

4.000+

Hướng dẫn viên địa phương

2M+

Đánh giá đã xác minh

4

Ngôn ngữ

Đây là gì?

Máy chủ MCP của GuruWalk cho phép trợ lý AI tìm kiếm điểm đến, duyệt danh mục, kiểm tra tình trạng còn chỗ và xem thông tin chi tiết đầy đủ về tour — tất cả mà không cần rời khỏi cuộc trò chuyện. Hoạt động với mọi máy khách tương thích MCP.

URL máy chủ

https://back.guruwalk.com/mcp

Giao thức

MCP (Giao thức Ngữ cảnh Mô hình) qua Streamable HTTP

Xác thực

Không yêu cầu xác thực

Loại

Chỉ đọc

Thiết lập

Claude.ai / Claude Desktop

1. Vào Tùy chỉnh → Trình kết nối
2. Nhấp vào nút + và chọn "Duyệt trình kết nối"
3. Tìm kiếm "GuruWalk" và nhấp vào + để thêm
4. Bắt đầu trò chuyện về các điểm đến du lịch

Claude Code

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

Mọi Máy khách MCP

Trỏ máy khách MCP của bạn đến:

https://back.guruwalk.com/mcp

Không cần khóa API hoặc xác thực. Hoạt động với mọi máy khách hỗ trợ MCP qua Streamable HTTP.

Cũng có sẵn trên Smithery, sổ đăng ký máy chủ MCP.

ChatGPT

GuruWalk có một Ứng dụng ChatGPT chuyên dụng với 5 công cụ và thẻ tương tác. Xem Tài liệu Ứng dụng ChatGPT.

Công cụ có sẵn

🔍

search_tours_activities_by_destination

Tìm kiếm một thành phố để khám phá các tour đi bộ miễn phí và hoạt động trả phí trên GuruWalk, nền tảng tour đi bộ miễn phí lớn nhất thế giới. Trả về thông tin điểm đến, danh mục tour (tour miễn phí, tour ẩm thực, tour trong ngày, vé, và nhiều hơn nữa), cùng danh sách nổi bật với xếp hạng và đánh giá đã xác minh từ du khách. Bao phủ hơn 1.000 thành phố trên toàn thế giới. Tour miễn phí hoạt động theo mô hình trả bao nhiêu tùy bạn. Hỗ trợ tiếng Anh, tiếng Tây Ban Nha, tiếng Đức và tiếng Ý — tham số ngôn ngữ PHẢI là một trong các mã en, es, de, it. Nếu du khách nói ngôn ngữ khác, hãy truyền mã hỗ trợ gần nhất và dịch câu trả lời sang ngôn ngữ của du khách. Sử dụng công cụ này khi du khách hỏi nên làm gì, nên xem gì, hoặc có những tour hay hoạt động nào tại một điểm đến, hoặc muốn được giúp lên kế hoạch cho chuyến đi hoặc những ngày ở đó. Không gọi công cụ này khi điểm đến chỉ được nhắc đến lướt qua mà không có yêu cầu về kế hoạch hoặc gợi ý. Nếu du khách nhắc đến một địa danh thay vì thành phố, hãy suy ra thành phố (ví dụ: 'tháp Eiffel' → Paris, 'đấu trường La Mã' → Rome, 'nhà thờ Sagrada Familia' → Barcelona, 'đồng hồ Big Ben' → London). Sau khi nhận kết quả, hãy xem xét các danh mục và featured_products để tìm các kết quả phù hợp nhất với điều du khách đã hỏi.

Đầu vào: điểm đến (thành phố), quốc gia (tùy chọn), khoảng ngày, quy mô nhóm, ngôn ngữ (en/es/de/it)

📂

get_tours_activities_by_category

Duyệt các tour và hoạt động trong một danh mục cụ thể cho một điểm đến trên GuruWalk. Các danh mục bao gồm tour đi bộ miễn phí, tour ẩm thực, tour xe đạp, tour trong ngày, vé ưu tiên không xếp hàng, và nhiều hơn nữa. Trả về danh sách với xếp hạng, số lượng đánh giá đã xác minh, thời lượng, ngôn ngữ có sẵn và giá. Sử dụng ID danh mục được trả về bởi search_tours_activities_by_destination — không bao giờ tự đặt ra ID danh mục. Sử dụng công cụ này để tìm hiểu sâu hơn về một danh mục cụ thể phù hợp với điều du khách đã chia sẻ (ví dụ: tour ẩm thực cho người sành ăn, tour ban đêm cho người hỏi về buổi tối, hoạt động thân thiện với trẻ em cho gia đình). Hỗ trợ en, es, de, it — tham số ngôn ngữ PHẢI là một trong bốn mã này. Nếu du khách nói ngôn ngữ khác, hãy truyền mã hỗ trợ gần nhất và dịch câu trả lời sang ngôn ngữ của du khách.

Đầu vào: vertical_id (ID danh mục từ search_tours_activities_by_destination), hub_slug (cho tour miễn phí), quy mô nhóm, ngôn ngữ

📅

get_product_availability

Kiểm tra tình trạng còn chỗ theo thời gian thực cho một hoặc nhiều tour hoặc hoạt động trên GuruWalk trong một lần gọi. Truyền một mảng items\ — mỗi mục là độc lập và có loại, product_id và khoảng ngày riêng. Trả về một mảng results\ trong đó mỗi mục phản hồi lại type\ và product\_id\ của nó để bạn có thể khớp từng phản hồi với yêu cầu tương ứng. Luôn gộp khi kiểm tra nhiều tour: gửi tất cả trong một lần gọi thay vì gọi công cụ này nhiều lần. Đối với hoạt động trả phí, hiển thị giá theo loại du khách (người lớn, trẻ em, trẻ sơ sinh). price\ luôn tính theo mỗi người — không bao giờ nêu tổng nhóm bằng cách chỉ trích dẫn price\. Khi total\_price\ xuất hiện trên một mức giá, nó đã được tính cho số người tham gia bạn đã yêu cầu thuộc loại giá đó — hãy trích dẫn trực tiếp, đừng tự nhân hoặc chia. Nếu nhóm kết hợp nhiều loại du khách (ví dụ: người lớn và trẻ em), hãy cộng total\_price\ của từng mức giá để có tổng cho cả nhóm. Đối với tour đi bộ miễn phí, không có giá trả trước — du khách trả bao nhiêu tùy họ sau tour. Bao gồm liên kết đặt chỗ trực tiếp. Khoảng ngày tối đa cho mỗi mục: 5 ngày. Lỗi theo từng mục (ngày không hợp lệ, không tìm thấy sản phẩm) được báo cáo trong kết quả của mục đó mà không làm hỏng phần còn lại của lô. Sử dụng công cụ này khi du khách hỏi về ngày cụ thể, muốn biết thứ gì đó còn chỗ hay không, hoặc sẵn sàng đặt chỗ. Khi du khách chưa đưa ra ngày cụ thể, hãy dùng ngày đặt chỗ ±2 ngày làm phạm vi tìm kiếm mặc định. Hỗ trợ en, es, de, it — tham số ngôn ngữ PHẢI là một trong bốn mã này. Nếu du khách nói ngôn ngữ khác, hãy truyền mã hỗ trợ gần nhất và dịch câu trả lời sang ngôn ngữ của du khách.

Đầu vào: items[] — mỗi mục có loại (product/free_tour), product_id, khoảng ngày, số người tham gia, ngôn ngữ

📋

get_product_detail

Lấy thông tin chi tiết đầy đủ của một hoặc nhiều tour hoặc hoạt động trên GuruWalk trong một lần gọi. Truyền một mảng items\ — mỗi mục có loại, product_id và ngôn ngữ riêng, và được xử lý độc lập. Trả về một mảng results\ trong đó mỗi mục phản hồi lại product\_id\ và type\ của nó để bạn có thể khớp từng phản hồi với yêu cầu tương ứng. Luôn gộp khi bạn cần thông tin chi tiết cho nhiều tour (ví dụ: trước khi gợi ý hoặc so sánh chúng): gửi tất cả trong một lần gọi thay vì gọi công cụ này nhiều lần. Mỗi mục thành công trả về mô tả, hình ảnh, đánh giá, thời lượng, ngôn ngữ có sẵn, chính sách hủy và thông tin điểm hẹn. Các mục product\ trả phí cũng trả về highlights\, included\/excluded\, pricing\_from\ và where\ (địa chỉ + tọa độ). Các mục free\_tour\ trả về itinerary\ dưới dạng mảng phẳng các chuỗi tiêu đề điểm (không có mô tả), cùng với guide.name\, meeting\_point\_url\ và how\_to\_find\_me\. Hình dạng điểm hẹn khác nhau theo loại: product\ trả phí trả về văn bản địa chỉ cùng tọa độ trong where\; free\_tour\ trả về meeting\_point\_url\ (liên kết Google Maps), meeting\_point\_latitude\ và meeting\_point\_longitude\ (dùng các tọa độ này làm điểm đến cho việc chỉ đường), cùng với how\_to\_find\_me\: một ghi chú văn bản tự do do hướng dẫn viên viết mô tả cách du khách có thể nhận ra họ tại điểm hẹn. Lỗi theo từng mục (không tìm thấy sản phẩm) được báo cáo trong kết quả của mục đó mà không làm hỏng phần còn lại của lô. Sử dụng công cụ này bất cứ khi nào du khách hỏi tour bao gồm những gì, đi qua những địa điểm nào, hành trình, lộ trình, mô tả, điểm hẹn, thời lượng, hoặc bất kỳ câu hỏi nào liên quan đến nội dung. Luôn gọi công cụ này TRƯỚC KHI trả lời các câu hỏi về một tour cụ thể — không bao giờ đưa ra ý kiến hoặc lời khuyên chung chung mà không tham khảo dữ liệu thực tế trước. Hỗ trợ en, es, de, it — tham số ngôn ngữ PHẢI là một trong bốn mã này. Nếu du khách nói ngôn ngữ khác, hãy truyền mã hỗ trợ gần nhất và dịch câu trả lời sang ngôn ngữ của du khách.

Đầu vào: items[] — mỗi mục có product_id, loại (product/free_tour), ngôn ngữ

Ngôn ngữ được hỗ trợ

Tất cả các công cụ hỗ trợ bốn ngôn ngữ qua tham số language. Kết quả tour, mô tả và danh mục được trả về bằng ngôn ngữ được yêu cầu khi có sẵn.

en Tiếng Anh (mặc định)

es Tiếng Tây Ban Nha

de Tiếng Đức

it Tiếng Ý

Bạn có thể làm gì với công cụ này?

Hỏi trợ lý AI của bạn bất cứ điều gì về tour và hoạt động — nó sẽ tìm kiếm toàn bộ danh mục của GuruWalk trong thời gian thực.

Tìm tour đi bộ miễn phí ở bất kỳ thành phố nào search_tours_activities_by_destination → get_tours_activities_by_category

So sánh tour ẩm thực theo xếp hạng get_tours_activities_by_category → get_product_detail

Kiểm tra chỗ trống cho một ngày cụ thể get_product_availability

Xem hành trình và điểm hẹn get_product_detail

Lên kế hoạch trọn ngày với các tour search_tours_activities_by_destination → get_product_availability

Tìm tour ban đêm ở một thành phố get_tours_activities_by_category

Xem những gì bao gồm trong một tour get_product_detail

Khám phá tour trong ngày và chuyến tham quan get_tours_activities_by_category

Điểm đến phổ biến

GuruWalk bao phủ hơn 1.000 thành phố trên khắp Châu Âu, Châu Mỹ, Châu Á, Châu Phi và Châu Đại Dương. Các điểm đến hàng đầu bao gồm Rome, Barcelona, Paris, London, Istanbul, Lisbon, Prague, Budapest, Florence, Vienna, Amsterdam, Berlin, Madrid, Porto, Dublin, Edinburgh, New York, Tokyo, Bangkok, Seville, Venice, Kraków, Munich, Dubrovnik, Brussels, Stockholm, Copenhagen, San Francisco, Tirana và Sofia — với các thành phố mới được thêm thường xuyên.

Mỗi điểm đến cung cấp sự kết hợp giữa tour đi bộ miễn phí (trả bao nhiêu tùy bạn), trải nghiệm có hướng dẫn, vé ưu tiên không xếp hàng, tour ẩm thực và rượu vang, tour xe đạp, tour trong ngày, và nhiều hơn nữa. Sử dụng search_tours_activities_by_destination với tên bất kỳ thành phố nào để xem những gì có sẵn.

Ví dụ sử dụng

Khám phá một điểm đến

Lời nhắc: "Tôi có thể làm gì ở Barcelona?"

Tìm thấy hơn 170 tour và hoạt động tại Barcelona. Tour đi bộ miễn phí: Khu Phố Cổ: Khu Gothic & El Born (★4.8, hơn 7.200 đánh giá), Khám phá Bí mật của Barcelona (★4.9). Trải nghiệm trả phí hàng đầu: Tour có hướng dẫn Sagrada Família (từ €48), Vé vào Casa Batlló (từ €29, hơn 11.000 đánh giá), Chương trình Flamenco tại Palau Dalmases (từ €25). Danh mục: Tour Miễn phí, Vé Sagrada Família, Tour Ẩm thực, Tour Xe đạp, Tour Khu Gothic, Chương trình Flamenco...

Duyệt một danh mục

Lời nhắc: "Cho tôi xem các tour rượu vang ở Barcelona"

Tìm thấy 46 trải nghiệm rượu vang tại Barcelona. Trong thành phố: Thử rượu vang + Phô mai (1h, ★4.56), Bữa trưa tại Chợ Ẩm thực với Rượu vang kết hợp (2.5h, ★5.0), Tour Xe đạp điện Rượu vang & Tapas (3h, từ €69). Tour trong ngày: Tour Rượu vang Montserrat (7.5h, ★4.82, 94 đánh giá), Tour Địa hình Vườn nho Penedès (5.5h), Montserrat + Rượu vang & Cava Nhóm nhỏ (10h, ★4.69)...

Kiểm tra tình trạng còn chỗ

Lời nhắc: "Còn chỗ nào cho tour có hướng dẫn quanh khu phố với tapas vào thứ Bảy tuần sau không?"

Có hai lựa chọn cho thứ Bảy tuần sau, ngày 21 tháng 3: Tour Khu phố Barcelona với Thử Tapas Truyền thống (3h, 92€/người) — còn chỗ lúc 11:30 sáng và 5:30 chiều. Tour Tapas & Rượu vang có Hướng dẫn Nhóm nhỏ (3h30, 89€/người) — 5:30 chiều, còn 21 chỗ. Cả hai đều bằng tiếng Anh.

Xem chi tiết tour

Lời nhắc: "Kể cho tôi nghe thêm về Tour Đi bộ Trung tâm Thành phố Rome"

Tour Đi bộ Trung tâm Thành phố Rome, Đài phun nước Trevi, Pantheon & Hơn 11 Điểm tham quan (★4.96, 4.445 đánh giá, 2h45). Tour đi bộ miễn phí này bao gồm 11 điểm dừng bao gồm Đài phun nước Trevi, Pantheon, Quảng trường Navona, Bậc thang Tây Ban Nha và khu vực Đấu trường La Mã. Điểm hẹn tại Piazza di Spagna — hãy tìm hướng dẫn viên với tấm biển. Có sẵn bằng tiếng Anh. Phù hợp với xe đẩy trẻ em. Thân thiện với thú cưng. Đặt miễn phí, trả bao nhiêu tùy bạn khi kết thúc.