Strava MCP

🚀 Strava API Function Documentation

This documentation provides detailed information about several functions in the Strava API, including how to use them, input parameters, output formats, and example requests and responses.

🚀 Quick Start

The following sections introduce different functions of the Strava API. Each function has specific input requirements and output formats, and requires valid access tokens and appropriate permissions.

✨ Features

• get-activity: Retrieve detailed information about a specified activity.
• get-activity-details: Obtain detailed statistical information about a specified activity, including heart rate, power, speed, and elevation data.
• get-athlete-zones: Get the user's current heart rate zone settings.

📚 Documentation

💻 Usage Examples

get-activity

Basic Usage

This function retrieves detailed information about a specified activity by its ID.

get-activity <activity_id>

Description

This function returns all available data for the specified activity. A valid access token is required, and appropriate permissions must be met.

Input Parameters

• <activity_id>: The unique identifier of the specified activity.

Output Format

Returns data in JSON format, including the following fields:

• id: Activity ID.
• name: Activity name.
• description: Activity description (optional).
• distance: Activity distance.
• elapsed_time: Total activity time.
• moving_time: Actual movement time during the activity.
• average_speed: Average speed.
• max_speed: Maximum speed.
• elevation_gain: Total elevation gain.
• start_latlng: Starting latitude and longitude coordinates.
• end_latlng: Ending latitude and longitude coordinates.
• map_summary: Activity map summary.
• notes: Activity notes (optional).

Example Request

{
  "activity_id": 1234567890
}

Example Response Fragment

{
  "id": 1234567890,
  "name": "Morning Ride",
  "description": null,
  "distance": 34.5,
  "elapsed_time": "02:30:15",
  "moving_time": "02:25:45",
  "average_speed": 16.7,
  "max_speed": 35.2,
  "elevation_gain": 89.3,
  "start_latlng": [37.7749, -122.4189],
  "end_latlng": [37.7749, -122.4189],
  "map_summary": "...",
  "notes": null
}

Important Note

• The activity:read permission is required.
• Activity data may vary due to privacy settings.

Error Information

• Missing or invalid token: 401 Unauthorized.
• Activity not found: 404 Not Found.

get-activity-details

Basic Usage

This function retrieves detailed statistical information about a specified activity.

get-activity-details <activity_id>

Description

This function returns all detailed statistical data related to the activity. A valid access token is required, and appropriate permissions must be met.

Input Parameters

• <activity_id>: The unique identifier of the specified activity.

Output Format

Returns data in JSON format, including the following fields:

• id: Activity ID.
• name: Activity name.
• distance: Activity distance.
• elapsed_time: Total activity time.
• moving_time: Actual movement time during the activity.
• average_speed: Average speed.
• max_speed: Maximum speed.
• elevation_gain: Total elevation gain.
• average_heart_rate: Average heart rate.
• max_heart_rate: Maximum heart rate.
• average_power: Average power.
• max_power: Maximum power.

Example Request

{
  "activity_id": 1234567890
}

Example Response Fragment

{
  "id": 1234567890,
  "name": "Morning Ride",
  "distance": 34.5,
  "elapsed_time": "02:30:15",
  "moving_time": "02:25:45",
  "average_speed": 16.7,
  "max_speed": 35.2,
  "elevation_gain": 89.3,
  "average_heart_rate": 120,
  "max_heart_rate": 180,
  "average_power": 250,
  "max_power": 300
}

Important Note

• The activity:read permission is required.
• Activity data may vary due to privacy settings.

Error Information

• Missing or invalid token: 401 Unauthorized.
• Activity not found: 404 Not Found.

get-athlete-zones

Basic Usage

This function retrieves the user's current heart rate zone settings.

get-athlete-zones

Description

This function returns the heart rate zone configuration related to the user. A valid access token is required, and appropriate permissions must be met.

Input Parameters

No input parameters.

Output Format

Returns data in JSON format, including the following fields:

• id: Zone ID.
• name: Zone name.
• min_bpm: Lower limit of the zone (beats per minute).
• max_bpm: Upper limit of the zone (beats per minute).

Example Response Fragment

[
  {
    "id": 1,
    "name": "Zone 1: Active Recovery",
    "min_bpm": 50,
    "max_bpm": 60
  },
  {
    "id": 2,
    "name": "Zone 2: Steady State",
    "min_bpm": 61,
    "max_bpm": 70
  },
  {
    "id": 3,
    "name": "Zone 3: Threshold",
    "min_bpm": 71,
    "max_bpm": 80
  }
]

Important Note

• The profile:read permission is required.

Error Information

• Missing or invalid token: 401 Unauthorized.
• Insufficient permissions: 403 Forbidden.

🤝 Contribution

If you have any questions or suggestions about this documentation, please visit Strava Developer Documentation.