LABSCO SUMMARY

Route planning that answers for your bike, not just the map.

The distinction it draws is a real one: other tools tell you where to go, this one tells you what the route will demand — the surface split against your tyres, the gradients on the climb, and the mud you will find when you get there.

What it is

A route planner for MTB, gravel, road and e-bike riding that answers in terms of the bike you are riding rather than the map. It aggregates open routing, geospatial and weather data and layers cycling-specific reasoning on top: whether the surface suits your tyres, what the gradients demand, and what the terrain will be like on the day.

What you get

Route planning against a distance and elevation target from a starting point, usable from an MCP client or the project's own GUI
Surface intelligence — the actual percentage of gravel against asphalt on a route, checked for compatibility with your bike and tyre width
Visual elevation profiles with gradients called out, so a climb can be paced rather than discovered
Terrain and weather context — mud risk and rain probability for the time you plan to ride
Setup advice — tyre pressure for a given rider weight, tyre size and conditions, plus a safety checklist
Local guides for specific areas, and post-ride analysis that compares your recorded ride against the conditions at the time

Requirements

Python 3.10, packaged as bikescout with an MCP server entry point; the project documentation covers setup for Claude Desktop, Cursor, Codex, Google Antigravity and Windsurf as well as the GUI. It aggregates data from open providers and you are bound by their terms: routing and map data from OpenRouteService, geospatial and geocoding data from OpenStreetMap under ODbL with Nominatim, and weather from Open-Meteo under CC BY 4.0. Licensed AGPL-3.0, which means a modified version offered as a network service must publish its source.

Setup effort

One command — uvx bikescout

See installation options

USE CASES

01

Planning a loop from where you are standing

Give a start point, a distance and a bike, and get a route back with the terrain checked against what you are riding.

02

Checking whether a route suits road tyres

Ask for the surface breakdown — the actual gravel against asphalt percentage — before committing to it.

03

Pacing a serious climb

Read the elevation profile with the steep sections highlighted, so the effort is planned rather than met head-on.

04

Getting the setup right before you leave

Calculate tyre pressure for your weight and tyre size in the conditions expected, and run the safety checklist.

05

Understanding why a ride felt slow

Compare a recorded ride's speed against the terrain conditions at that time rather than blaming your legs.

06

Riding somewhere you do not know

Use a local guide for the area so the plan reflects what locals know, not just what the map shows.

BEFORE YOU INSTALL

What to know first

Requires

uvx on PATH

INSTALLATION

Connect your client

Add the block to your client, or run the command directly.

Server setup

Configuration file

JSON

{
  "mcpServers": {
    "bikescout": {
      "command": "uvx",
      "args": [
        "bikescout"
      ]
    }
  }
}

uvx

TERMINAL

uvx bikescout

BikeScout