# Bicycle routes generator MCP

> Bicycle routes generator MCP is an MCP server for maps and travel. Generate MTB and road cycling routes on OpenStreetMap trails as GPX with safety warnings. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/marc-armillas/bicycle-routes-generator-mcp
- **MCP Registry name:** io.github.Marc-Armillas/bicycle-routes-generator-mcp
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

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

## 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.

## Alternatives

- [Atli](https://ai-powered.com/mcp/atli): Atli is a free MCP server for maps and travel.
- [CAD2GIS](https://ai-powered.com/mcp/cad2gis): CAD2GIS is an open-source MCP server for engineering simulation.
- [Coordinates](https://ai-powered.com/mcp/coordinates): Coordinates is a freemium MCP server for maps and travel.
- [Photon](https://ai-powered.com/mcp/photon): Photon is a freemium MCP server for maps and travel.
- [Travel Advisories](https://ai-powered.com/mcp/travel-advisories): Travel Advisories is a freemium MCP server for maps and travel.
- [Sunvane Golden Hour](https://ai-powered.com/mcp/sunvane-golden-hour): Sunvane Golden Hour is an MCP server for maps and travel.
- [Openrouteservice](https://ai-powered.com/mcp/openrouteservice): Openrouteservice is a freemium MCP server for maps and travel.
- [Geodistance](https://ai-powered.com/mcp/geodistance): Geodistance is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/bicycle-routes-generator-mcp
