# GuruWalk Affiliates

Подключает каталог бесплатных пеших экскурсий GuruWalk к вашему агенту: поиск туров по городам, категориям и датам, ссылки на бронь с вашим партнёрским ref.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: guruwalk
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/guruwalk/affiliates-mcp
- Обновлён: 2026-08-27
- HTML: https://affpapa.org/nevibecode/mcp/guruwalk-affiliates

## Что делает

Сервер отдаёт три инструмента. `discover_destination` ищет туры в городе и возвращает категории и подборку популярных экскурсий, `browse_category` раскрывает конкретную категорию по её id, а `check_availability` показывает ближайшие даты и время начала по id тура. Язык названий и описаний задаётся параметром `language`: `en`, `es`, `de` или `it`.

Работает по Streamable HTTP в stateless-режиме: каждый запрос независим, состояние между вызовами не хранится. В клиенте это надо выставить явно — `stateless: true` или аналог. Без ключа API любой запрос вернёт `401 Unauthorized`, так что ключ нужен до первого запуска. Передавайте его в заголовке `Authorization: Bearer <api_key>` либо `Api-Key: <api_key>`.

Все поля `url` и `booking_url` в ответах уже содержат `?ref=<username>` — брони, пришедшие через агента, засчитываются вашему аккаунту. Эти параметры не срезайте и не правьте, иначе атрибуция потеряется. Для подключения годится любая MCP-совместимая библиотека: `mcp` для Python или `@modelcontextprotocol/sdk` для TypeScript.

## Требования
- Удалённый сервер: `https://back.guruwalk.com/mcp/affiliates`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliates
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add guruwalk-affiliates --url https://back.guruwalk.com/mcp/affiliates
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "guruwalk-affiliates": {
            "url": "https://back.guruwalk.com/mcp/affiliates"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "guruwalk-affiliates": {
            "type": "http",
            "url": "https://back.guruwalk.com/mcp/affiliates"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliates
```

## Когда брать
- найти бесплатные пешие экскурсии в городе по названию
- показать туры внутри категории с рейтингом и обложками
- проверить, на какие даты есть свободные слоты у тура
- собрать ссылку на бронь с партнёрским `ref` для клиента
- встроить подбор экскурсий в разговор с туристическим ассистентом

## Примеры запросов агенту
- Найди бесплатные экскурсии в Барселоне на английском и покажи категории
- Покажи все туры в категории с id 5
- Проверь, какие слоты есть у тура 101 с 10 по 12 июня

## Похожие
- [openaffiliate-mcp](https://affpapa.org/nevibecode/mcp/openaffiliate-mcp.md) — MCP-сервер · ★ 119
- [hotelbooking-ai](https://affpapa.org/nevibecode/mcp/hotelbooking-ai.md) — MCP-сервер · ★ 86
- [hotelbooking](https://affpapa.org/nevibecode/mcp/hotelbooking.md) — MCP-сервер · ★ 51
- [variflight-mcp](https://affpapa.org/nevibecode/mcp/variflight-mcp.md) — MCP-сервер · ★ 33
- [Tripsy](https://affpapa.org/nevibecode/mcp/tripsy.md) — MCP-сервер · ★ 22
- [referrals](https://affpapa.org/nevibecode/skills/referrals.md) — скилл · 72500 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md