# GuruWalk Affiliates

Wires the GuruWalk free walking tour catalog into your agent: find tours by city, category or date, and get booking links that carry your affiliate ref.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: guruwalk
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/guruwalk/affiliates-mcp
- Updated: 2026-08-27
- HTML: https://affpapa.org/en/nevibecode/mcp/guruwalk-affiliates

## What it does

Three tools ship with the server. `discover_destination` looks up a city and returns its categories plus a page of featured tours. `browse_category` takes a category id and lists the tours inside it. `check_availability` takes a tour id and a date range, then returns the time slots. Tour names and descriptions come back in the language you ask for: `en`, `es`, `de` or `it`.

The transport is Streamable HTTP in stateless mode, so nothing carries over between calls. Set that in your client config — `stateless: true` or the equivalent. No valid key means `401 Unauthorized` on every request, so get one before you connect. Send it as `Authorization: Bearer <api_key>` or as `Api-Key: <api_key>`.

Every `url` and `booking_url` in a response already carries `?ref=<username>`, which is how bookings from your agent get credited to your account. Strip or edit those parameters and the attribution is gone. On the client side, any MCP-compatible library works: `mcp` for Python, `@modelcontextprotocol/sdk` for TypeScript.

## Requirements
- Remote server: `https://back.guruwalk.com/mcp/affiliates`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliates
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add guruwalk-affiliates --url https://back.guruwalk.com/mcp/affiliates
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "guruwalk-affiliates": {
            "url": "https://back.guruwalk.com/mcp/affiliates"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "guruwalk-affiliates": {
            "type": "http",
            "url": "https://back.guruwalk.com/mcp/affiliates"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliates
```

## When to use it
- find free walking tours in a city by name
- list the tours inside one category with ratings and images
- check which dates a given tour still has open slots
- hand a client a booking link that carries your affiliate `ref`
- fold tour suggestions into a travel assistant conversation

## Example prompts
- Find free walking tours in Barcelona in English and show me the categories
- List every tour in category id 5
- Check which slots tour 101 has between June 10 and June 12

## Similar
- [openaffiliate-mcp](https://affpapa.org/en/nevibecode/mcp/openaffiliate-mcp.md) — MCP server · ★ 119
- [hotelbooking-ai](https://affpapa.org/en/nevibecode/mcp/hotelbooking-ai.md) — MCP server · ★ 86
- [hotelbooking](https://affpapa.org/en/nevibecode/mcp/hotelbooking.md) — MCP server · ★ 51
- [variflight-mcp](https://affpapa.org/en/nevibecode/mcp/variflight-mcp.md) — MCP server · ★ 33
- [Tripsy](https://affpapa.org/en/nevibecode/mcp/tripsy.md) — MCP server · ★ 22
- [referrals](https://affpapa.org/en/nevibecode/skills/referrals.md) — skill · 72500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md