Create wiki page 'MCP Tools Reference'

2026-05-14 19:44:29 +00:00
parent 149b956459
commit b26a8f140e
1 changed files with 109 additions and 0 deletions
@@ -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)*