MCP server for Komoot — tours, highlights, route planning & more.
komoot-mcp has 18 tools with complete input schemas and descriptions in French. Naming follows verb_noun convention (download_, get_, list_, create_, update_, delete_, upload_). However, descriptions are brief (avg ~80 chars, below the 194-char baseline), lack WHEN/WHY context, and omit output schema documentation. Parameters are typed but lack constraints (enums, ranges). Error handling is minimal, no recovery guidance or actionable error messages. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Composition is sound (single responsibility), but descriptions don't guide LLM selection between similar tools (e.g., plan_route vs import_gpx_route).
Creer un tour planifie sur Komoot a partir d'un resultat de plan_route ou import_gpx_route.
Supprimer un tour.
Telecharger un tour au format FIT (format Garmin/ANT+).
Telecharger un tour au format GPX (trace GPS complete).
Detail d'un highlight Komoot (point d'interet communautaire).
Conseils/tips de la communaute pour un highlight.
Descriptions lack WHEN/WHY context and output schema documentation. Avg description length ~80 chars (baseline 194). LLMs cannot determine when to select plan_route vs import_gpx_route without explicit differentiation.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Agents cannot infer safety/retry semantics.
Parameters lack enum constraints and range limits. sport parameter accepts free-form strings instead of enum ['hike', 'touringbicycle', 'mtb', 'racebicycle', 'jogging', ...]. Invites hallucinated values.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | <=2025-11-25 | v2 |
Detail complet d'un tour (distance, denivele, duree, sport, difficulte, surfaces, etc.).
Sequence de coordonnees d'un tour (lat, lng, alt, timestamp).
Instructions de navigation turn-by-turn d'un tour planifie.
Lister les images/photos d'un tour.
Types de surface par segment d'un tour (asphalte, gravier, terre, etc.).
Types de voie par segment d'un tour (route, piste cyclable, sentier, etc.).
Profil de l'utilisateur Komoot connecte (nom, avatar, stats).
Importer un fichier GPX et le matcher sur le reseau routier Komoot. Etape 1/2 pour creer un tour planifie a partir d'un GPX externe. Utiliser ensuite create_planned_tour() avec le resultat.
Lister tes tours Komoot (planifies et enregistres).
Planifier un itineraire Komoot a partir de waypoints.
Modifier les metadonnees d'un tour.
Uploader un fichier GPX comme activite enregistree sur Komoot.
No error handling guidance. KomootError raised but no recovery hints (e.g., 'User not found. Try list_tours() first.'). Agents cannot self-correct on failures.
list_tours pagination parameters (page, limit) lack documented constraints. No mention of max limit (100) or default behavior. Agents may request unbounded results.