# Hüttentouren.org

> Mehrtägige Hüttentouren in den Alpen planen — kuratierte Routen mit
> tagesaktueller Hüttenverfügbarkeit aus den Alpenvereins-Buchungssystemen
> (DAV, ÖAV, AVS, SAC).

Hüttentouren.org kombiniert Routeninhalte (Etappen, Höhenprofil, Übernachtungshütten)
mit Echtzeit-Verfügbarkeit aus mehreren Booking-Portalen. Der Fokus liegt auf
planbaren, buchbaren Touren im deutschsprachigen Alpenraum. Inhalte sind auf
Deutsch; numerische Felder und IDs sind sprachneutral.

## MCP Server

- **Endpoint:** https://www.huettentouren.org/api/mcp
- **Transport:** Streamable HTTP (Model Context Protocol)
- **Auth:** keine (public)
- **Discovery:** https://www.huettentouren.org/.well-known/mcp.json
- **Landingpage:** https://www.huettentouren.org/fuer-ki-agenten
- **Smithery Registry:** https://smithery.ai/server/philippvoss2212/huettentouren

### Tools

- `recommend_tours` — ranked Tour-Empfehlungen nach harten Filtern (Schwierigkeit, Dauer, Personen, Reisemonate, Zeitfenster) und weichen Präferenzen (Transport, Saison). Liefert bei frischer Verfügbarkeit konkrete Startdaten.
- `search_tours` — Fuzzy-Textsuche über Routennamen und Regionen.
- `get_tour` — volle Etappen-Details inkl. Übernachtungshütten und Buchungslinks.

### Freshness & Status-Vertrag

- `bookable` — Verfügbarkeit ≤8h alt, Buchungslinks sicher
- `content_only` — Verfügbarkeit stale (≤12h) oder fehlend, nur Inhalt liefern
- `no_match` — keine Tour entspricht den Filtern (klar unterschieden von Systemfehlern)
- Degradation-Flags: `stale`, `off_season`, `missing`, `validation_error`

## Key pages

- [/](https://www.huettentouren.org/): Startseite mit Erklärung und Einstiegspunkten
- [/search](https://www.huettentouren.org/search): Tour-Suche mit Karte und Filtern
- [/tour/{id}](https://www.huettentouren.org/tour/berliner-hoehenweg): Einzelne Tour mit Etappen, Hütten, Verfügbarkeit
- [/fuer-ki-agenten](https://www.huettentouren.org/fuer-ki-agenten): Installation und Nutzung des MCP-Servers
- [/sitemap.xml](https://www.huettentouren.org/sitemap.xml): Vollständiger Seitenindex

## Optional

- [/datenschutz](https://www.huettentouren.org/datenschutz): DSGVO-Hinweise (relevant für MCP-Preference-Events)
- [/impressum](https://www.huettentouren.org/impressum): Betreiber-Kontakt
- [/dav-bettencheck-alternative](https://www.huettentouren.org/dav-bettencheck-alternative): Vergleich mit DAV Bettencheck
- [/huettentouren-vs-hut-reservation](https://www.huettentouren.org/huettentouren-vs-hut-reservation): Vergleich mit hut-reservation.org

## Data sources

Routen- und Hüttendaten werden redaktionell kuratiert und gegen folgende
Buchungssysteme aggregiert: Casablanca (DAV Bettencheck), Hüttenholiday,
hut-reservation.org (Alpenvereine). Verfügbarkeit wird serverseitig mit
einem klaren Freshness-Fenster exponiert; Agenten sollten keine Daten
raten, wenn `status != "bookable"`.