# Bike Router

> Bike Router is a free MCP server for maps and travel. Plan bike routes from an OpenStreetMap service you host, with weather and sights. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** self-hosted, CLI, Web
- **Repository:** https://github.com/jonasheinickebio/pybikerouter
- **MCP Registry name:** io.github.JonasHeinickeBio/bike-router
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

Bike Router connects an assistant to a running pyBikeRouter API, whose address you set with BIKE_ROUTER_API_URL (default 127.0.0.1:8000). The registry describes it as facts only: the language model may parse a sentence or explain a route, but coordinates, geometry, elevation and suitability come from OSM-based routing engines.

The underlying service geocodes with Nominatim or Pelias and flags ambiguous places for clarification instead of guessing. It routes with openrouteservice, which needs an API key, and also has BRouter and Valhalla adapters. Candidate routes get deterministic scores and are exported as GeoJSON or GPX. Optional features include a forecast along the route at the departure time, sights near a route, and a map-based web planner.

There is a no-code Docker bundle with a Start file, a command line tool, and iPhone use over Tailscale. The MCP package is a PyPI stdio server and the tool names are not listed in the README text.

## Features

- **Facts-only routing:** Geometry, elevation and suitability come from routing engines, not the model.
- **Bike-type profiles:** Plans for bike types such as gravel or touring with a target distance.
- **Ambiguity handling:** Ambiguous place names trigger a clarification instead of a guess.
- **Weather along route:** Forecast at departure time including wind relative to riding direction.
- **Sights near a route:** Finds points of interest along a route, ranked by fame.
- **GPX and GeoJSON export:** Exports routes and alternatives.

## Good for

- Plan a 50 km gravel loop from a city
- Check wind and rain along a planned ride
- Find sights worth stopping at on a route
- Export a route to a GPS device as GPX

## Install

### Claude Code (Terminal)

```sh
claude mcp add bike-router --env BIKE_ROUTER_API_URL='<BIKE_ROUTER_API_URL>' -- uvx bike-router
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "<BIKE_ROUTER_API_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "<BIKE_ROUTER_API_URL>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "bike-router": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bike-router"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "<BIKE_ROUTER_API_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "<BIKE_ROUTER_API_URL>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "<BIKE_ROUTER_API_URL>"
      }
    }
  }
}
```

## FAQ

### Does it run in the cloud?

No. It talks to a pyBikeRouter service you run yourself.

### What does routing need?

An openrouteservice API key for live routing, per the README.

### Is there a non-programmer install?

Yes, a zip with Docker Desktop and a Start file.

### Does the model invent coordinates?

No. The README says coordinates and elevation come from OSM-derived engines.

### Is Bike Router free?

Yes. Bike Router is free to use.

### How do I add Bike Router to Claude Code?

Run this command in your terminal: claude mcp add bike-router --env BIKE_ROUTER_API_URL='<BIKE_ROUTER_API_URL>' -- uvx bike-router

### What are the best alternatives to Bike Router?

The closest alternatives to Bike Router 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/bike-router
