GuruWalk Affiliates MCP server

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= parameter automatically, so bookings driven by your agent are attributed to your account.

Endpoint

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:

Authorization: Bearer <api_key>

or

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

Response

{
  "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 categoryid from discoverdestination results. Returns paginated tours with ratings, images, and booking URLs.

Parameters

Response

Shortened. The full README is on GitHub.