Bikescout
AI for tactical cycling intelligence: Predictive mud logic, S-Scale terrain analysis, and AI-powered GPX routing
What is Bikescout?
Bikescout is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ai for tactical cycling intelligence: predictive mud logic, s-scale terrain analysis, and ai-powered gpx routing
AI for tactical cycling intelligence: Predictive mud logic, S-Scale terrain analysis, and AI-powered GPX routing
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- AI for tactical cycling intelligence: Predictive mud logic,
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bikescoutConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bikescout
BikeScout MCP Server is a Python-based MCP server that provides AI-powered tactical cycling intelligence, connecting AI assistants to route planning, terrain analysis, and weather risk assessment tools for cyclists. It integrates with OpenRouteService for GPX routing, Open-Meteo for weather forecasts, and OpenStreetMap for geodata, exposing capabilities like predictive mud logic via the TAEL Mud Reservoir Model, S-Scale terrain grading, tire pressure calculations, and post-ride analysis. Cyclists, coaches, and outdoor app developers use it to plan safer and more informed routes through natural language conversations with their AI assistant.
Prerequisites
- Python 3.10 or later installed
- pip package manager
- An OpenRouteService API key (free tier available at openrouteservice.org)
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
- A Python virtual environment (recommended)
Create and activate a virtual environment
Set up an isolated Python environment to avoid dependency conflicts.
python -m venv bikescout-venv
source bikescout-venv/bin/activate # On Windows: bikescout-venv\Scripts\activateInstall BikeScout
Install the bikescout package from PyPI.
pip install bikescoutObtain an OpenRouteService API key
Sign up for a free account at openrouteservice.org and generate an API key from your dashboard. This is required for GPX routing.
Add to your MCP client configuration
Add the BikeScout server to your MCP client config, providing the path to your virtual environment's Python binary and the ORS_API_KEY environment variable.
{
"mcpServers": {
"bikescout": {
"command": "/path/to/bikescout-venv/bin/python",
"args": ["-u", "-m", "bikescout.mcp_server"],
"env": {
"PYTHONPATH": "/path/to/bikescout-venv/lib/python3.10/site-packages",
"ORS_API_KEY": "your_openrouteservice_api_key"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your MCP client to load the BikeScout server.
Bikescout Examples
Client configuration
Configuration block for claude_desktop_config.json using a local Python virtual environment and an OpenRouteService API key.
{
"mcpServers": {
"bikescout": {
"command": "/Users/yourname/bikescout-venv/bin/python",
"args": ["-u", "-m", "bikescout.mcp_server"],
"env": {
"PYTHONPATH": "/Users/yourname/bikescout-venv/lib/python3.10/site-packages",
"ORS_API_KEY": "your_ors_api_key_here"
}
}
}
}Prompts to try
Sample prompts for route planning, terrain analysis, weather risk, and post-ride evaluation.
- "Plan a 25km MTB loop near Girona, check rain probability for this weekend, and flag any high-mud-risk segments"
- "What is the S-Scale terrain grade for this GPX file? [attach GPX]"
- "Calculate recommended tire pressure for a 75kg rider on a 29-inch MTB tackling 40% gravel"
- "Analyze my last ride and compare my average speed against the mud risk conditions on the route"
- "Check if my 25mm road bike tires are compatible with the surface mix on the Barcelona-Montserrat route"Troubleshooting Bikescout
Server fails to start with 'ModuleNotFoundError: No module named bikescout'
Ensure PYTHONPATH in the MCP config env points to the site-packages directory of the virtual environment where bikescout was installed. Activate the venv and run 'pip show bikescout' to confirm the install location.
Routing requests fail with API error
Verify your ORS_API_KEY is correctly set in the MCP config env block. Check your OpenRouteService dashboard to ensure the key is active and you have not exceeded the free tier quota.
Weather data unavailable for a region
Open-Meteo covers global weather data and does not require an API key, but some remote regions may have limited historical data. Try querying for a nearby larger location or check the Open-Meteo coverage map.
Frequently Asked Questions about Bikescout
What is Bikescout?
Bikescout is a Model Context Protocol (MCP) server that ai for tactical cycling intelligence: predictive mud logic, s-scale terrain analysis, and ai-powered gpx routing It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bikescout?
Follow the installation instructions on the Bikescout GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bikescout?
Bikescout works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bikescout free to use?
Yes, Bikescout is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Bikescout Alternatives — Similar Developer Tools Servers
Looking for alternatives to Bikescout? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bikescout in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bikescout?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.