Vanmoof MCP Server

VanMoof MCP Server is a server that implements the MCP specification, used to connect AI agents with VanMoof services, providing functions such as user bicycle data, cycling cities, preference settings, and cycling statistics.

Home automation and IoT Travel and transportation #Bicycle Data #Cycling Statistics #User Preferences #Urban Cycling .Python

rating : 2 points

downloads : 6.3K

update time : 2025-04-29

Open Site

What is VanMoof MCP Server?

VanMoof MCP Server is a tool based on the Model Context Protocol (MCP), aiming to provide detailed information about riders and their bicycles through integration with VanMoof's services. For example, it can obtain details of your VanMoof bicycle, riding preferences, the city you're in, and weekly cycling statistics.

How to use VanMoof MCP Server?

With just a few simple steps, you can easily access and manage your VanMoof cycling data. First, you need to install Python and the uv tool. Then, clone the GitHub repository and configure the environment variables. Finally, run the server and conduct tests.

Applicable Scenarios

VanMoof MCP Server is very suitable for users who want to gain in - depth understanding of their personal cycling habits, optimize their cycling experience, or participate in cycling community activities.

Main Features

Get Customer Data

Retrieve detailed customer information from authenticated VanMoof users.

Get VanMoof City List

Obtain city data from the VanMoof API.

Get Rider Preferences

Retrieve rider preference settings from authenticated VanMoof users.

Get Total Ride Summary

Retrieve the total ride summary from authenticated VanMoof users.

Advantages

Seamlessly connect AI agents with VanMoof services.

Provide detailed rider and bicycle data.

Support multiple query methods to meet personalized needs.

Limitations

Users need to manually configure environment variables.

It is only available for authenticated VanMoof users.

Some technical background may be required to complete the initial setup.

How to Use

Install Python

Make sure Python is installed on your computer. If not, refer to the official guide for installation.

Install uv Tool

Install the uv tool to improve development efficiency. Please follow the instructions in the official documentation for installation.

Clone the GitHub Repository

Run the following command in the terminal to clone the GitHub repository of VanMoof MCP Server.

Configure Environment Variables

Rename the.env - example file to.env and fill in your VanMoof credentials.

Start the Server

Start the server using the MCP CLI or npx @modelcontextprotocol/inspector.

Usage Examples

Get Bicycle Details

Send a request to VanMoof MCP Server to obtain detailed information about the current user's bicycle.

Compare Cycling Statistics

Compare personal cycling data with the average cycling data of the world and the city where the user is located.

Frequently Asked Questions

How do I start using VanMoof MCP Server?

Are my VanMoof credentials secure?

Related Resources

Create a Model Context Protocol (MCP) Server Project

Learn how to quickly set up a Python server based on MCP.

MCP Inspector

A powerful tool for testing and debugging MCP servers.

🚲 VanMoof MCP Server

The VanMoof MCP Server implements the MCP Specification to establish a seamless connection between AI agents and VanMoof's key services, such as VanMoof customer data, bike details, VanMoof rider cities, rider preference settings, and weekly riding statistics.

🚀 Quick Start

✨ What can you do with the VanMoof MCP Server?

The VanMoof MCP Server enhances the capabilities of your agents by providing them with background information about VanMoof riders. Here are some cool prompts you can try:

🔍 Explore your customer data

"Please give me the details of my VanMoof bike."
"What is the name of my VanMoof bike?"
"What is the serial number of my VanMoof bike?"
"What is the color of my VanMoof bike?"

🏙️ City rides

"In which cities (globally) is VanMoof riding data tracked?"
"Create a table listing the tracked VanMoof riding cities in the Netherlands with columns for longitude and latitude."
"Retrieve and format a list of the tracked VanMoof riding cities in the Netherlands and present it as a table, including columns for longitude and latitude."

⚙️ Your rider preferences

"Get my VanMoof rider preferences."
"Which city is set in my VanMoof rider profile?"

🚲 Explore your VanMoof riding statistics

"Please give me the weekly riding statistics (VanMoof) for March 25, 2025."
"What is my maximum speed on my VanMoof bike?"
"What is my longest riding time on my VanMoof bike?"
"What are the city statistics for this week?"
"What are the global statistics for bikes?"
"Compare the city statistics with the global statistics. What conclusions can you draw?"
"Compare my weekly VanMoof riding statistics with the city and global bike statistics. Store the results as a Markdown table for comparison."

✨ Features

🛠️ Currently supported tools

get_customer_data: Retrieve customer data from authenticated VanMoof users.
get_vanmoof_cities: Retrieve a list of city data from the VanMoof API.
get_rider_preferences: Retrieve rider preference settings from authenticated VanMoof users.
get_rides_summary: Retrieve the total riding summary from authenticated VanMoof users.
get_rides_for_week(date_in_week: str = ""): Retrieve riding data for a specific week from authenticated VanMoof users.
get_city_rides_thisweek: Retrieve the total riding summary of VanMoof riders in the city this week.
get_world_rides_thisweek: Retrieve the total riding summary of VanMoof riders globally this week.