Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Bicycle routes generator MCP

by Marc-Armillasversion 0.5.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.Marc-Armillas/bicycle-routes-generator-mcp

How to install

What it does

MTB and road cycling routes on real OpenStreetMap trails, saved as GPX with safety warnings.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use Bicycle routes generator MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Bicycle routes generator MCP or shows a Bicycle routes generator MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Bicycle routes generator MCP yet

Bicycle routes generator MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Bicycle routes generator MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Bicycle routes generator MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Bicycle routes generator MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect Bicycle routes generator MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Bicycle routes generator MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect Bicycle routes generator MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Bicycle routes generator MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Bicycle routes generator MCP💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.5.0
Categoryi
Other
Published to registryi
Oct 19, 2026
Code last changedi
Nov 6, 2026
Maker
Marc-Armillas
Packages
mcpb: …/bicycle-routes-generator-mcp.mcpb
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Marc-Armillas, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 14 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/marc-armillas-bicycle-routes-generator-mcp.svg)](https://mcp.popnx.com/en/servers/marc-armillas-bicycle-routes-generator-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20815 servers in this category
  • Published to the registry more recently than 58% of the other 20815 servers in this category
  • Basic checks equal to or better than 99% of the other 20815 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Bicycle routes generator MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 14 days ago, and the latest version (0.5.0) reached the registry 32 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 4 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 31 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Bicycle routes generator MCP
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Bicycle routes generator MCP

English · Español

[⬇️ Download the Claude Desktop extension (bicycle-routes-generator-mcp.mcpb)](https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/latest/download/bicycle-routes-generator-mcp.mcpb)

Generates mountain bike and road cycling routes from a location and saves them as GPX with elevation. The track is computed by a routing engine (BRouter or OpenRouteService) on real OpenStreetMap trails and roads: neither the AI nor the application invents coordinates.

You can use it:

  • With Claude (Claude Desktop or Claude Code) through a local MCP server: "make me a ~25 km MTB loop from Casa de Campo in Madrid, little climbing, on dirt tracks" (see what happens when you ask Claude).
  • From the terminal, without AI: bicycle-routes generate "Casa de Campo, Madrid" --km 25 --type tracks.

Every route comes with a summary (distance, climbing, maximum grade, % of pavement, dirt track and singletrack) and warnings: sections with motor traffic, grades over 12 %, protected areas, ways where bikes are not allowed and technical sections.

💾 GPX files go to `/tmp/bicycle-routes` by default. macOS empties /tmp on restart and cleans

up old files, so copy the routes you want to keep (or set BIKE_GPX_DIR to another folder).

⚠️ Always check the route on a map before riding. OpenStreetMap data may be incomplete

or out of date, and does not reflect temporary closures or every local regulation. Climbing

is computed from a digital elevation model (~90 m) and **may differ from what a barometric

watch or bike computer records** (often by 10-20 %); short ramps may be smoothed out.

Easy install in Claude Desktop (.mcpb extension)

  1. Download bicycle-routes-generator-mcp.mcpb (always the latest release), or build it with npx @anthropic-ai/mcpb pack . dist/bicycle-routes-generator-mcp.mcpb.
  2. Double-click the file (or drag it into Claude Desktop → Settings → Extensions) and click Install.
  3. Fill in the configuration: the GPX folder (/tmp/bicycle-routes by default) and a contact email (required by the OpenStreetMap/Nominatim usage policy). The other fields are optional.
  4. Ask Claude: "make me a 25 km MTB loop from Casa de Campo in Madrid on dirt tracks".

No need to install Python: this is a uv extension, so Claude Desktop downloads Python and the dependencies automatically the first time (it can take a minute). .mcpb is the successor of the .dxt format; older Claude Desktop versions that only support .dxt cannot run uv extensions.

Manual install (CLI and Claude Code)

Requirements: macOS, Windows or Linux with uv (it installs Python for you).

git clone <repository-url> bicycle-routes-generator-mcp

cd bicycle-routes-generator-mcp uv sync cp .env.example .env # and edit it

Configuration (environment variables)

There are no keys or personal data in the code: everything is configured through environment variables (or a .env file in the folder you run the CLI from).

VariableDefaultPurpose
BIKE_GPX_DIR/tmp/bicycle-routesFolder where GPX files are saved. The app only writes here (and to its .bicycle-routes/ subfolder with cache and index). On Windows the default is the system temp folder.
BIKE_CONTACT—Email or URL sent in the User-Agent. Recommended: required by Nominatim's policy.
BIKE_ENGINEbrouterbrouter or ors.
BIKE_BROUTER_URLhttps://brouter.deBRouter server (public or local, see below).
ORS_API_KEY—Free OpenRouteService key if BIKE_ENGINE=ors.
BIKE_PROTECTED_AREAS1Check protected areas with the Overpass API.
BIKE_GARMIN_MCP_COMMAND—Only for --garmin in the CLI (see "Garmin").
BIKE_DATA_DIR /.bicycle-routesWhere to keep the cache and index.

Command-line usage

uv run bicycle-routes generate "Casa de Campo, Madrid" --km 25 --type tracks --max-climb 500

uv run bicycle-routes generate "40.4242,-3.7559" --km 15 # coordinates work too uv run bicycle-routes generate "Casa de Campo, Madrid" --km 20 --end "El Pardo, Madrid" # point-to-point uv run bicycle-routes generate "Casa de Campo, Madrid" --km 30 --via "El Pardo, Madrid" --via "Aravaca, Madrid" # loop through via points uv run bicycle-routes generate "Madrid" --km 60 --type road # road bike uv run bicycle-routes generate "Casa de Campo, Madrid" --km 40 --seed 7 # another reproducible alternative uv run bicycle-routes generate "Casa de Campo, Madrid" --km 25 --json # JSON output uv run bicycle-routes list

Trail types (--type):

  • tracks: favours wide dirt tracks, little singletrack and no extreme ramps.
  • mixed (default): general MTB.
  • singletrack: more singletrack, less pavement.
  • road: road bike. Paved roads with little traffic; warns about unpaved sections and only about busy roads (main roads or heavy estimated traffic), not ordinary secondary roads.

Real example (abridged):

MTB Casa de Campo 38 km loop

Start: Casa de Campo, Madrid, Comunidad de Madrid, España Distance: 37.8 km · Climbing: +336 m / -338 m · Elevation 615–725 m Max grade: 10.3 % uphill, 13.3 % downhill Surface: paved 28.8 % · track 40.6 % · singletrack 30.6 % Engine: brouter (mtb) · candidates evaluated: 6 GPX: /tmp/bicycle-routes/mtb-casa-de-campo-38-km-loop-20261017-163919.gpx Warnings:

  • [traffic] 0.3 km on roads with motor traffic in 1 section(s); ride carefully.
  • [traffic] Road with traffic (km 27.3–27.6).
  • [grade] Steep descent over 12 % (max ~13 %, km 9.2–9.3).
  • [general] Climbing and grades come from a digital elevation model (~90 m resolution)…
  • [general] Route generated automatically from OpenStreetMap: check it on a map before riding…

More examples with real output in docs/pruebas-reales.md (in Spanish).

Using it with Claude (MCP server)

The server exposes two tools:

  • generate_route(start, distance_km, max_climb_m?, trail_type?, loop=true, end?, name?, seed?, via?) → GPX path, summary and warnings. via is a list of places the route must pass through, in order (e.g. "a loop from Casa de Campo passing through El Pardo and Aravaca").
  • list_routes() → saved routes.
Example: what happens when you ask Claude

You: *"Make me a ~40 km MTB loop from Casa de Campo in Madrid."*

1. Claude calls the tool, choosing the arguments from your request:

generate_route({ "start": "Casa de Campo, Madrid", "distance_km": 40, "trail_type": "mixed" })

2. The MCP server computes the route on your computer (10-60 seconds):

  1. Looks up "Casa de Campo, Madrid" in Nominatim (OpenStreetMap) → 40.424, -3.756.
  2. Generates 6 candidate loops with BRouter on real trails, adjusting each one to about 40 km.
  3. Scores them (distance, traffic, repeated trails, surface, forbidden access, climbing) and keeps the best one.
  4. Analyses it: climbing, grades, surface, sections with traffic, technical sections and protected areas (Overpass API).
  5. Saves the GPX with elevation in your GPX folder.

3. It returns this to Claude (real output, abridged; obtained with "seed": 2026 so it can be reproduced: without a seed every request gives a different loop):

{

"name": "MTB Casa de Campo 38 km loop", "gpx_file": "/tmp/bicycle-routes/mtb-casa-de-campo-38-km-loop-20261017-163919.gpx", "start": { "name": "Casa de Campo, Madrid, Comunidad de Madrid, España", "lat": 40.4241907, "lon": -3.755858 }, "summary": { "distance_km": 37.8, "ascent_m": 336, "descent_m": 338, "min_elevation_m": 615, "max_elevation_m": 725, "max_uphill_grade_pct": 10.3, "max_downhill_grade_pct": 13.3, "surface_pct": { "paved": 28.8, "track": 40.6, "path": 30.6, "unknown": 0.0 }, "warnings": [ { "kind": "traffic", "message": "0.3 km on roads with motor traffic in 1 section(s); ride carefully." }, { "kind": "traffic", "message": "Road with traffic (km 27.3–27.6).", "start_km": 27.32, "end_km": 27.61 }, { "kind": "grade", "message": "Steep descent over 12 % (max ~13 %, km 9.2–9.3).", "start_km": 9.22, "end_km": 9.34 }, { "kind": "general", "message": "Climbing and grades come from a digital elevation model (~90 m resolution)…" }, { "kind": "general", "message": "Route generated automatically from OpenStreetMap: check it on a map before riding…" } ] }, "engine": "brouter (mtb)", "activity_type": "mountain_biking", "candidates_evaluated": 6, "attribution": "Trail data © OpenStreetMap contributors (ODbL) — https://www.openstreetmap.org/copyright" }

4. Claude answers you in your language, with the summary and every warning. For example (illustrative, Claude's wording varies):

I've created a 37.8 km loop from Casa de Campo with +336 m of climbing: 41 % dirt

track, 31 % singletrack and 29 % paved. Watch out for 0.3 km on a road with traffic

(km 27.3–27.6) and a steep descent of ~13 % at km 9.2. Climbing comes from an elevation

model and may differ from your watch, so check the route on a map before riding.

GPX: /tmp/bicycle-routes/mtb-casa-de-campo-38-km-loop-20261017-163919.gpx

From there you can keep going in the same conversation:

You sayWhat Claude does
"Give me another option"Calls generate_route again with a different seed
"Less climbing, at most 200 m"Adds max_climb_m: 200
"Make it pass through El Pardo"Adds via: ["El Pardo, Madrid"]
"Now a 60 km road ride from Madrid"Uses trail_type: "road" (paved, little traffic)
"Upload it to Garmin"Calls the Garmin MCP server's upload_course with the GPX, if you have it installed
"What routes have I saved?"Calls list_routes
Claude Code
claude mcp add bicycle-routes-generator-mcp \

-e BIKE_GPX_DIR=/tmp/bicycle-routes -e BIKE_CONTACT=you@example.com \ -- uv run --directory /path/to/bicycle-routes-generator-mcp bicycle-routes-mcp

Claude Desktop (without the extension)

The .mcpb extension is the easiest option (see above). To configure it by hand instead: Settings → Developer → Edit config (claude_desktop_config.json):

{

"mcpServers": { "bicycle-routes-generator-mcp": { "command": "/absolute/path/to/uv", "args": ["run", "--directory", "/path/to/bicycle-routes-generator-mcp", "bicycle-routes-mcp"], "env": { "BIKE_GPX_DIR": "/tmp/bicycle-routes", "BIKE_CONTACT": "you@example.com" } } } }

Use the absolute path to uv (which uv on macOS/Linux, where uv on Windows), because Claude Desktop does not always inherit the terminal's PATH. Restart Claude Desktop.

Building the extension

manifest.json describes the extension (uv type, tools and configuration fields) and .mcpbignore keeps the tests, docs and your .env out of the package.

npx @anthropic-ai/mcpb validate manifest.json

npx @anthropic-ai/mcpb pack . dist/bicycle-routes-generator-mcp.mcpb python scripts/make_icon.py # only if you want to regenerate icon.png

Publishing a release
  1. Bump version in manifest.json, pyproject.toml and src/bicycle_routes/__init__.py together.
  2. Create and push a matching tag:
   git tag v0.1.0

git push origin v0.1.0

  1. The Release GitHub Actions workflow runs the tests, builds bicycle-routes-generator-mcp.mcpb and attaches it to a new GitHub

Only the beginning is shown; read the rest in the repo