From b26a8f140ec73fb98b05db138274c102df59c4ac Mon Sep 17 00:00:00 2001
From: Matthias Hinrichs <matthias.hinrichs@me.com>
Date: Thu, 14 May 2026 19:44:29 +0000
Subject: [PATCH] Create wiki page 'MCP Tools Reference'

---
 MCP-Tools-Reference.md | 109 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 MCP-Tools-Reference.md

diff --git a/MCP-Tools-Reference.md b/MCP-Tools-Reference.md
new file mode 100644
index 0000000..7bfa9f3
--- /dev/null
+++ b/MCP-Tools-Reference.md
@@ -0,0 +1,109 @@
+# 🛠️ MCP Tools Reference
+
+All tools provided by the Strava MCP Server, grouped by category.
+
+Every tool returns two outputs:
+- **User Content** — formatted Markdown for display in chat
+- **Assistant Resource** — structured JSON for LLM processing (`strava://...`)
+
+---
+
+## 🏃 Athlete
+
+| Tool | Description |
+|------|-------------|
+| `get_athlete_profile` | Full athlete profile including bio, location, and follower counts |
+| `get_athlete_stats` | Lifetime and yearly totals (distance, time, elevation) |
+| `get_athlete_zones` | Heart rate and power zones |
+
+---
+
+## 🚴 Activities
+
+| Tool | Description |
+|------|-------------|
+| `list_activities` | Paginated list of recent activities with filters |
+| `get_activity_details` | Full details of a specific activity |
+| `get_activity_laps` | Lap data for an activity |
+| `get_activity_zones` | Heart rate and power zones for an activity |
+| `get_activity_streams` | Raw time-series data (HR, power, cadence, GPS, etc.) |
+| `get_activity_comments` | User comments on an activity |
+| `get_activity_kudoers` | List of users who gave kudos |
+| `get_starred_segments_for_activity` | Starred segments within an activity |
+
+---
+
+## 🏟️ Clubs
+
+| Tool | Description |
+|------|-------------|
+| `get_athlete_clubs` | All clubs the athlete is a member of |
+| `get_club_activities` | Recent activities from club members |
+| `get_club_members` | List of club members |
+
+---
+
+## 🛣️ Routes
+
+| Tool | Description |
+|------|-------------|
+| `list_athlete_routes` | All routes saved by the athlete |
+| `get_route_details` | Full details of a specific route |
+
+---
+
+## 🏆 Segments
+
+| Tool | Description |
+|------|-------------|
+| `get_segment` | Details about a specific segment |
+| `list_starred_segments` | Segments starred by the athlete |
+| `get_segment_leaderboard` | Top efforts on a segment |
+
+---
+
+## 📏 Segment Efforts
+
+| Tool | Description |
+|------|-------------|
+| `list_segment_efforts` | All efforts by the athlete on a segment |
+| `get_segment_effort` | Details of a specific segment effort |
+
+---
+
+## ⚙️ Gear
+
+| Tool | Description |
+|------|-------------|
+| `get_gear` | Details of a specific piece of equipment (bike/shoe) |
+| `list_athlete_gear` | All gear registered to the athlete with mileage |
+
+---
+
+## 🔧 Server
+
+| Tool | Description |
+|------|-------------|
+| `get_server_info` | Server version, transport mode, auth status, and tool categories |
+
+---
+
+## 💬 Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `analyze_training_week` | Structured prompt for weekly training analysis |
+| `compare_activities` | Prompt for comparing two or more activities |
+
+---
+
+## Data Format Notes
+
+- **Dates**: Always returned in ISO 8601 UTC format. Present to users in their local format.
+- **Distances**: Always in **meters** — convert to km or miles for display.
+- **Speed**: Always in **m/s** — convert to km/h or min/km pace for display.
+- **Elevation**: Always in **meters**.
+
+---
+
+*Back to [Home](Home)*