guruwalk avatar

GuruWalk Affiliates

guruwalk/affiliates-mcp

Connects Claude to GuruWalk's free walking tour catalog across 100+ countries. You get three tools: discover_destination to search cities and get featured tours, browse_category to filter by theme (Ancient Rome, street art, etc.), and check_availability to pull real event slots with dates and times. Every URL comes back with your affiliate ref parameter baked in, so bookings go straight to your account. Authentication is bearer token over stateless HTTP. Useful if you're building a travel agent that needs to suggest and link specific tour inventory rather than just talking about destinations. The API returns structured tour data with ratings, images, and direct booking links.

tools
3
auth
Secret needed
transport
HTTP
last updated
Mar 24, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

discover_destinationFind free walking tours available in a city. Returns the destination info, tour categories to browse, and a paginated list of featured tours. Optionally filter by date range and language.

Find free walking tours available in a city. Returns the destination info, tour categories to browse, and a paginated list of featured tours. Optionally filter by date range and language.

No parameter schema in public metadata yet.

browse_categoryList free walking tours within a category. Use a `category_id` from `discover_destination` results. Returns paginated tours with ratings, images, and booking URLs.

List free walking tours within a category. Use a `category_id` from `discover_destination` results. Returns paginated tours with ratings, images, and booking URLs.

No parameter schema in public metadata yet.

check_availabilityCheck when a free walking tour has upcoming events. Use a `tour_id` from `discover_destination` or `browse_category` results. Returns available time slots with dates, times, languages, and booking URLs.

Check when a free walking tour has upcoming events. Use a `tour_id` from `discover_destination` or `browse_category` results. Returns available time slots with dates, times, languages, and booking URLs.

No parameter schema in public metadata yet.

Sponsors

Readme

GuruWalk MCP server for affiliates

GuruWalk runs a Model Context Protocol (MCP) server for the members of its affiliate programme. It lets your AI assistants and agents look up GuruWalk's free-tour catalogue while they talk with a traveller: which tours a destination has, what a category offers and when a tour runs.

The server only returns free tours. Every guruwalk.com link it returns already carries your affiliate code, so bookings that start from your assistant are attributed to you.

What it is for

Use it when an AI assistant or agent is in a conversation with a traveller and needs to look up what that traveller is asking about: the free tours of a city, the tours of one kind, the days and times a tour runs.

It is not meant for downloading the catalogue or building tour listings on your site. For that, affiliates have the tours API, documented in the affiliate panel.

Endpoint

POST https://back.guruwalk.com/mcp/affiliates

MCP over Streamable HTTP, POST only. Any MCP client library works; Examples has one client in Python and one in TypeScript.

Authentication


View the full README on GitHub

Details

Repository
github.com/guruwalk/affiliates-mcp
Website
www.guruwalk.com/afiliados
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from guruwalk