Skip to content
MCP server

Bicycle routes generator MCP

Generate MTB and road cycling routes on OpenStreetMap trails as GPX with safety warnings

Runs locallyStatus and history
Install
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.5.0
Listing updated
today

Similar MCP servers

About Bicycle routes generator MCP

Bicycle routes generator MCP is an MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

The tool never lets the model make up coordinates. A routing engine, BRouter by default or OpenRouteService with a free key, computes the track on real OpenStreetMap trails and roads. Given a start place, a distance and optional limits on climbing and trail type, it creates six candidate loops, scores them on distance, traffic, repeated trails, surface, forbidden access and climbing, keeps the best one and saves a GPX file with elevation.

Each route comes with a summary of distance, climbing, maximum grade and the share of pavement, dirt track and singletrack, plus warnings about stretches with motor traffic, grades above 12 percent, protected areas, ways closed to bikes and technical sections. Trail types are tracks, mixed, singletrack and road, and routes can be loops, point to point or forced through via points. A seed makes a result reproducible.

The author cautions to check every route on a map, since OpenStreetMap data can be out of date and the elevation model has about 90 m resolution, so climbing may differ by 10 to 20 percent from a bike computer. It runs locally as a Claude Desktop extension or from the command line with uv.

Install

Run in a terminal

claude mcp add bicycle-routes-generator-mcp -- npx -y https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bicycle-routes-generator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bicycle-routes-generator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bicycle-routes-generator-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bicycle-routes-generator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bicycle-routes-generator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

generate_route
Generate a route from a start place and distance, returning the GPX path, summary and warnings.
list_routes
List saved routes.

What it does

Real-trail routing
Uses BRouter or OpenRouteService on OpenStreetMap data.
GPX with elevation
Saves routes as GPX files in a folder you choose.
Route summary
Reports distance, climbing, grades and surface mix.
Safety warnings
Flags traffic, steep grades, protected areas and restricted ways.
Trail types
Offers tracks, mixed, singletrack and road modes.
Via points and seeds
Routes through chosen places and can reproduce a result.

Good for

  • Plan a 25 km MTB loop on dirt tracks from a city park
  • Make a road-bike route with little traffic
  • Create a point-to-point ride between two towns
  • Export a GPX for a bike computer

Pricing

Pricing unknown

Licence not stated in the README; uses free public routing services

Bicycle routes generator MCP FAQ

Does the AI invent coordinates?

No, the track is computed by a routing engine on OpenStreetMap data.

Where are GPX files saved?

In /tmp/bicycle-routes by default, which can be changed.

Do I need an API key?

Not for the default BRouter engine; OpenRouteService needs a free key.

How accurate is climbing?

It comes from a ~90 m elevation model and may differ 10 to 20 percent from a bike computer.

How do I add Bicycle routes generator MCP to Claude Code?

Run this command in your terminal: claude mcp add bicycle-routes-generator-mcp -- npx -y https://github.com/Marc-Armillas/bicycle-routes-generator-mcp/releases/download/v0.5.0/bicycle-routes-generator-mcp.mcpb

What are the best alternatives to Bicycle routes generator MCP?

The closest alternatives to Bicycle routes generator MCP are Atli, CAD2GIS, Coordinates, Photon and Travel Advisories.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers