mcp-server-vanmoof

Instructions

Implementation Reference

• server.py:137-158 (handler)

  Handler function implementing the get_vanmoof_cities tool. Authenticates using helper methods and makes a GET request to the VanMoof API to retrieve city data. Registered via @mcp.tool() decorator.
  @mcp.tool() # Function to get vanMoof Cities def get_vanmoof_cities() -> Dict[str, Any]: """ Retrieves a list of city data from the vanMoof API. Returns: The rider vanMoof's city data if authentication is successful, otherwise None. """ # 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"} url = "https://tenjin.vanmoof.com/api/v1/cities" headers = { "authorization": f"Bearer {application_token}", "api-key": "fcb38d47-f14b-30cf-843b-26283f6a5819" } response = requests.get(url, headers=headers) return response.json()
• server.py:40-77 (helper)

  Helper method in VanMoofAPI class to obtain the initial VanMoof access token using basic auth.
  def get_vanmoof_token(username, password): """ Authenticates with the VanMoof API and retrieves an access token. Args: username: The user's VanMoof email address. password: The user's VanMoof password. Returns: The access token string if authentication is successful, otherwise None. """ api_key = 'fcb38d47-f14b-30cf-843b-26283f6a5819' uri_prefix = 'https://my.vanmoof.com/api/v8' auth_url = f'{uri_prefix}/authenticate' # Prepare Basic Authentication credentials auth_string = f"{username}:{password}" encoded_auth_string = base64.b64encode(auth_string.encode('ascii')).decode('ascii') headers = { 'Authorization': f'Basic {encoded_auth_string}', 'Api-Key': api_key } try: response = requests.post(auth_url, headers=headers) response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx) # Parse the JSON response and extract the token token = response.json().get('token') return token except requests.exceptions.RequestException as e: print(f"An error occurred during the API request: {e}") return None except Exception as e: print(f"An unexpected error occurred: {e}") return None
• server.py:79-113 (helper)

  Helper method in VanMoofAPI class to exchange the access token for an application token required for API calls.
  def get_application_token(token): """ Authenticates with the VanMoof API and retrieves an application token. Args: token: The user's VanMoof access token. Returns: The application token string if authentication is successful, otherwise None. """ api_key = 'fcb38d47-f14b-30cf-843b-26283f6a5819' uri_prefix = 'https://api.vanmoof-api.com/v8' auth_url = f'{uri_prefix}/getApplicationToken' headers = { 'authorization': f'Bearer {token}', "accept": "*/*", "user-agent": "VanMoof-Rider/23.7 (sdk_gphone_x86_arm, Android 11)", 'api-key': api_key } try: response = requests.get(auth_url, headers=headers) response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx) # Parse the JSON response and extract the token application_token = response.json() return application_token.get('token') except requests.exceptions.RequestException as e: print(f"An error occurred during the API request: {e}") return None except Exception as e: print(f"An unexpected error occurred: {e}") return None
• server.py:115-135 (helper)

  Related tool/helper to get customer data, which is used in other tools but called within the cities handler indirectly.
  @mcp.tool() # Function to get customer data def get_customer_data() -> Dict[str, Any]: """ Retrieves customer data from the vanMoof API. Returns: The rider vanMoof's customer data if authentication is successful, otherwise None. """ # Get the Bearer token from the authenticate method token = VanMoofAPI.get_vanmoof_token(VANMOOF_USERNAME, VANMOOF_PASSWORD) if not token: return {"error": "Authentication failed"} url = "https://my.vanmoof.com/api/v8/getCustomerData" headers = { "authorization": f"Bearer {token}", "api-key": "fcb38d47-f14b-30cf-843b-26283f6a5819" } response = requests.get(url, headers=headers) return response.json()