get_rides_summary
Retrieve ride statistics including total rides, distance, and average duration for authenticated VanMoof riders to analyze cycling activity.
Instructions
Retrieves total rides summary for the VanMoof rider being authenticated.
Returns:
The a summary of the total rides of the VanMoof rider if authentication is successful, otherwise None.
The following information is returned:
- Average distance in km
- Total Rides
- Average duration in minutes
- Total distance in km
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- server.py:245-298 (handler)The main handler function for the get_rides_summary MCP tool. It authenticates with the VanMoof API, retrieves rider and bike IDs, constructs a request for weekly rides summary, and returns the summary data including average distance, total rides, average duration, and total distance.
@mcp.tool() def get_rides_summary()-> Dict[str, Any]: """ Retrieves total rides summary for the VanMoof rider being authenticated. Returns: The a summary of the total rides of the VanMoof rider if authentication is successful, otherwise None. The following information is returned: - Average distance in km - Total Rides - Average duration in minutes - Total distance in km """ # Get the Bearer token from the authenticate method token = VanMoofAPI.get_vanmoof_token(VANMOOF_USERNAME, VANMOOF_PASSWORD) application_token = VanMoofAPI.get_application_token(token) if not application_token: return {"error": "Authentication failed"} # Get the riderId from the customer data customerData = VanMoofAPI.get_customer_data() riderId = customerData.get('data', {}).get('uuid') if not riderId: return {"error": "RiderId not found"} bikeId = customerData.get('data', {}).get('bikes', [{}])[0].get('id') if not bikeId: return {"error": "BikeId not found"} country = customerData.get('data', {}).get('country') if not country: return {"error": "CountryCode not found"} last_seen_week = datetime.now().strftime("%Y-%m-%d") # Ensure last_seen_week is the Monday of the week date_obj = datetime.strptime(last_seen_week, "%Y-%m-%d") monday = date_obj - timedelta(days=date_obj.weekday()) last_seen_week = monday.strftime("%Y-%m-%d") url = f"https://tenjin.vanmoof.com/api/v1/rides/{riderId}/{bikeId}/weekly" querystring = {"lastSeenWeek": last_seen_week, "limit": str(1)} headers = { "authorization": f"Bearer {application_token}", "api-key": "fcb38d47-f14b-30cf-843b-26283f6a5819", "cache-control": "no-cache, private", "accept-language": f"{country.lower()}_{country.upper()}", "accept-encoding": "gzip", "timezone": timezone_name, "accept": "*/*", } response = requests.get(url, headers=headers, params=querystring) return response.json().get('carousel', {}).get('summary', {})