GuruWalk Affiliates

GuruWalk affiliate program for AI agents. Free walking tours in 100+ countries. Earn per booking.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for GuruWalk Affiliates, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Capabilities & Tool Schemas (9)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by GuruWalk Affiliates.

destination

City or destination name, e.g. `"Rome"`, `"Barcelona"

language

Language for tour names and descriptions. One of: `en`, `es`, `de`, `it

start_date

Only show tours available from this date (`YYYY-MM-DD`)

end_date

Only show tours available until this date (`YYYY-MM-DD`)

page

Page number for the featured tours list

category_id

Category ID returned by `discover_destination

Documentation Overview

GuruWalk MCP — Affiliate Integration Guide

GuruWalk exposes a subset of its tour catalog through the Model Context Protocol (MCP), allowing affiliates to embed tour discovery, browsing, and availability checking directly into their own AI agents and assistants.

All URLs returned by the tools include your affiliate ?ref=<username> parameter automatically, so bookings driven by your agent are attributed to your account.

Endpoint

Code

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

The server implements MCP over Streamable HTTP, stateless mode. Every request is independent — no session state is maintained between calls.

Authentication

Include your API key on every request using one of these headers:

Code

Authorization: Bearer <api_key>

Code

Api-Key: <api_key>

Requests without a valid key receive 401 Unauthorized.

Protocol

This server follows the MCP specification. Use any MCP-compatible client library:

Python: mcp
TypeScript/JavaScript: @modelcontextprotocol/sdk

The transport is Streamable HTTP (not SSE, not stdio). The server is stateless — pass stateless: true (or equivalent) in your client transport configuration.

Tools

`discover_destination`

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.

Parameters

Name	Type	Required	Default	Description
`destination`	string	yes	—	City or destination name, e.g. `"Rome"`, `"Barcelona"`
`language`	string	no	`"en"`	Language for tour names and descriptions. One of: `en`, `es`, `de`, `it`
`start_date`	string	no	—	Only show tours available from this date (`YYYY-MM-DD`)
`end_date`	string	no	—	Only show tours available until this date (`YYYY-MM-DD`)
`page`	integer	no	`1`	Page number for the featured tours list

Response

config.json

{
  "place": {
    "id": 12,
    "name": "Rome",
    "slug": "rome",
    "country": "Italy",
    "has_free_tours": true
  },
  "pagination": {
    "page": 1,
    "per_page": 12,
    "total_count": 34
  },
  "categories": [
    {
      "id": 5,
      "name": "Ancient Rome",
      "url": "https://www.guruwalk.com/en/walks/rome/ancient-rome?ref=myaffiliate"
    }
  ],
  "featured_products": [
    {
      "id": 101,
      "name": "Classic Rome Free Tour",
      "slug": "classic-rome-free-tour",
      "rating_out_of_5": 4.9,
      "reviews_count": 312,
      "image_url": "https://cdn.guruwalk.com/tours/101.jpg",
      "url": "https://www.guruwalk.com/walks/classic-rome-free-tour?ref=myaffiliate"
    }
  ]
}

`browse_category`

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

Parameters

Name	Type	Required	Default	Description
`category_id`	integer	yes	—	Category ID returned by `discover_destination`
`language`	string	no	`"en"`	Language for tour names and category labels. One of: `en`, `es`, `de`, `it`
`page`	integer	no	`1`	Page number for paginated results

Response

config.json

{
  "category": {
    "id": 5,
    "name": "Ancient Rome",
    "url": "https://www.guruwalk.com/en/walks/rome/ancient-rome?ref=myaffiliate"
  },
  "place": {
    "name": "Rome",
    "slug": "rome"
  },
  "pagination": {
    "page": 1,
    "per_page": 12,
    "total_count": 8
  },
  "products": [
    {
      "id": 101,
      "name": "Classic Rome Free Tour",
      "slug": "classic-rome-free-tour",
      "rating_out_of_5": 4.9,
      "reviews_count": 312,
      "image_url": "https://cdn.guruwalk.com/tours/101.jpg",
      "url": "https://www.guruwalk.com/walks/classic-rome-free-tour?ref=myaffiliate"
    }
  ]
}

`check_availability`

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.

Parameters

Name	Type	Required	Default	Description
`tour_id`	integer	yes	—	Tour ID from `discover_destination` or `browse_category` results
`from_date`	string	yes	—	Start of date range (`YYYY-MM-DD`)
`to_date`	string	yes	—	End of date range (`YYYY-MM-DD`)
`language`	string	no	`"en"`	Language for tour names and descriptions. One of: `en`, `es`, `de`, `it`

Response

The dates object contains one key per day in the requested range. Days with no events have an empty array.

config.json

{
  "tour_id": 101,
  "from_date": "2025-06-10",
  "to_date": "2025-06-12",
  "dates": {
    "2025-06-10": [
      {
        "event_id": 9901,
        "start_time": "10:00",
        "language": "en",
        "last_seats": false,
        "booking_url": "https://www.guruwalk.com/walks/classic-rome-free-tour?beginsAt=2025-06-10&endsAt=2025-06-10&ref=myaffiliate"
      }
    ],
    "2025-06-11": [],
    "2025-06-12": [
      {
        "event_id": 9902,
        "start_time": "11:00",
        "language": "en",
        "last_seats": true,
        "booking_url": "https://www.guruwalk.com/walks/classic-rome-free-tour?beginsAt=2025-06-12&endsAt=2025-06-12&ref=myaffiliate"
      }
    ]
  }
}

Typical Flow

A natural conversation flow for a travel assistant looks like this:

Code

1. discover_destination(destination: "Barcelona", language: "en")
   → get place info, category list, and featured tours

2. browse_category(category_id: <id from step 1>, language: "en")
   → drill into a specific category to see all tours

3. check_availability(tour_id: <id from step 1 or 2>, from_date: "...", to_date: "...")
   → show the user available dates and times with direct booking links

You can also skip step 2 and go directly from discover_destination to check_availability if the user already selected a tour from the featured list.

Attribution

All url and booking_url fields in every tool response automatically include ?ref=<your_username> so bookings originating from your agent are tracked and credited to your account. Do not strip or modify these parameters.

Reference

MCP specification: https://modelcontextprotocol.io
Python SDK: https://pypi.org/project/mcp/
TypeScript SDK: https://www.npmjs.com/package/@modelcontextprotocol/sdk

Read the full README →View source on GitHub →

Related MCP Servers

View all in Travel & Transportation View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

29d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about GuruWalk Affiliates

We don't have a confirmed install command for GuruWalk Affiliates yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/guruwalk/affiliates-mcp) for the current steps.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

GuruWalk Affiliates AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/guruwalk-affiliates?style=directory)](https://allmcps.com/mcp/guruwalk-affiliates)

HTML Embed

<a href="https://allmcps.com/mcp/guruwalk-affiliates"><img src="https://allmcps.com/api/badge/guruwalk-affiliates?style=directory" alt="GuruWalk Affiliates on AllMCPs" /></a>

Technical Specs & Signals

CategoryTravel & Transportation

11/12 checks healthy over the last 46d

45Quality signal: Fair · 45/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools20/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🚆 Travel & Transportation →Best MCP servers for Travel & Transportation →Alternatives to GuruWalk Affiliates →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

GuruWalk Affiliates

GuruWalk affiliate program for AI agents. Free walking tours in 100+ countries. Earn per booking.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Capabilities & Tool Schemas (9)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by GuruWalk Affiliates.

destination

City or destination name, e.g. `"Rome"`, `"Barcelona"

language

Language for tour names and descriptions. One of: `en`, `es`, `de`, `it

start_date

Only show tours available from this date (`YYYY-MM-DD`)

end_date

Only show tours available until this date (`YYYY-MM-DD`)

page

Page number for the featured tours list

category_id

Category ID returned by `discover_destination

Documentation Overview

GuruWalk MCP — Affiliate Integration Guide

All URLs returned by the tools include your affiliate ?ref=<username> parameter automatically, so bookings driven by your agent are attributed to your account.

Endpoint

Code

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

The server implements MCP over Streamable HTTP, stateless mode. Every request is independent — no session state is maintained between calls.

Authentication

Include your API key on every request using one of these headers:

Code

Authorization: Bearer <api_key>

Code

Api-Key: <api_key>

Requests without a valid key receive 401 Unauthorized.

Protocol

This server follows the MCP specification. Use any MCP-compatible client library:

Python: mcp
TypeScript/JavaScript: @modelcontextprotocol/sdk

The transport is Streamable HTTP (not SSE, not stdio). The server is stateless — pass stateless: true (or equivalent) in your client transport configuration.

Tools

`discover_destination`

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.

Parameters

Name	Type	Required	Default	Description
`destination`	string	yes	—	City or destination name, e.g. `"Rome"`, `"Barcelona"`
`language`	string	no	`"en"`	Language for tour names and descriptions. One of: `en`, `es`, `de`, `it`
`start_date`	string	no	—	Only show tours available from this date (`YYYY-MM-DD`)
`end_date`	string	no	—	Only show tours available until this date (`YYYY-MM-DD`)
`page`	integer	no	`1`	Page number for the featured tours list

Response

config.json

{
  "place": {
    "id": 12,
    "name": "Rome",
    "slug": "rome",
    "country": "Italy",
    "has_free_tours": true
  },
  "pagination": {
    "page": 1,
    "per_page": 12,
    "total_count": 34
  },
  "categories": [
    {
      "id": 5,
      "name": "Ancient Rome",
      "url": "https://www.guruwalk.com/en/walks/rome/ancient-rome?ref=myaffiliate"
    }
  ],
  "featured_products": [
    {
      "id": 101,
      "name": "Classic Rome Free Tour",
      "slug": "classic-rome-free-tour",
      "rating_out_of_5": 4.9,
      "reviews_count": 312,
      "image_url": "https://cdn.guruwalk.com/tours/101.jpg",
      "url": "https://www.guruwalk.com/walks/classic-rome-free-tour?ref=myaffiliate"
    }
  ]
}

`browse_category`

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

Parameters

Name	Type	Required	Default	Description
`category_id`	integer	yes	—	Category ID returned by `discover_destination`
`language`	string	no	`"en"`	Language for tour names and category labels. One of: `en`, `es`, `de`, `it`
`page`	integer	no	`1`	Page number for paginated results

Response

config.json

{
  "category": {
    "id": 5,
    "name": "Ancient Rome",
    "url": "https://www.guruwalk.com/en/walks/rome/ancient-rome?ref=myaffiliate"
  },
  "place": {
    "name": "Rome",
    "slug": "rome"
  },
  "pagination": {
    "page": 1,
    "per_page": 12,
    "total_count": 8
  },
  "products": [
    {
      "id": 101,
      "name": "Classic Rome Free Tour",
      "slug": "classic-rome-free-tour",
      "rating_out_of_5": 4.9,
      "reviews_count": 312,
      "image_url": "https://cdn.guruwalk.com/tours/101.jpg",
      "url": "https://www.guruwalk.com/walks/classic-rome-free-tour?ref=myaffiliate"
    }
  ]
}

`check_availability`

Parameters

Name	Type	Required	Default	Description
`tour_id`	integer	yes	—	Tour ID from `discover_destination` or `browse_category` results
`from_date`	string	yes	—	Start of date range (`YYYY-MM-DD`)
`to_date`	string	yes	—	End of date range (`YYYY-MM-DD`)
`language`	string	no	`"en"`	Language for tour names and descriptions. One of: `en`, `es`, `de`, `it`

Response

The dates object contains one key per day in the requested range. Days with no events have an empty array.

config.json

{
  "tour_id": 101,
  "from_date": "2025-06-10",
  "to_date": "2025-06-12",
  "dates": {
    "2025-06-10": [
      {
        "event_id": 9901,
        "start_time": "10:00",
        "language": "en",
        "last_seats": false,
        "booking_url": "https://www.guruwalk.com/walks/classic-rome-free-tour?beginsAt=2025-06-10&endsAt=2025-06-10&ref=myaffiliate"
      }
    ],
    "2025-06-11": [],
    "2025-06-12": [
      {
        "event_id": 9902,
        "start_time": "11:00",
        "language": "en",
        "last_seats": true,
        "booking_url": "https://www.guruwalk.com/walks/classic-rome-free-tour?beginsAt=2025-06-12&endsAt=2025-06-12&ref=myaffiliate"
      }
    ]
  }
}

Typical Flow

A natural conversation flow for a travel assistant looks like this:

Code

1. discover_destination(destination: "Barcelona", language: "en")
   → get place info, category list, and featured tours

2. browse_category(category_id: <id from step 1>, language: "en")
   → drill into a specific category to see all tours

3. check_availability(tour_id: <id from step 1 or 2>, from_date: "...", to_date: "...")
   → show the user available dates and times with direct booking links

You can also skip step 2 and go directly from discover_destination to check_availability if the user already selected a tour from the featured list.

Attribution

Reference

MCP specification: https://modelcontextprotocol.io
Python SDK: https://pypi.org/project/mcp/
TypeScript SDK: https://www.npmjs.com/package/@modelcontextprotocol/sdk

Read the full README →View source on GitHub →

Related MCP Servers

View all in Travel & Transportation View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

29d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about GuruWalk Affiliates

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/guruwalk-affiliates?style=directory)](https://allmcps.com/mcp/guruwalk-affiliates)

HTML Embed

<a href="https://allmcps.com/mcp/guruwalk-affiliates"><img src="https://allmcps.com/api/badge/guruwalk-affiliates?style=directory" alt="GuruWalk Affiliates on AllMCPs" /></a>

Technical Specs & Signals

CategoryTravel & Transportation

11/12 checks healthy over the last 46d

45Quality signal: Fair · 45/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools20/30

Adoption & activity4/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.