# Route AI

> Free AI route planner for cycling, hiking and running. Describe a trip in
> plain language (any language) and get an editable route on a real map with
> elevation, then export GPX or a Garmin-native FIT course.

Route AI (https://route-ai.app) turns a chat message like "60 km gravel loop
from Gdansk through the forest" or a week-long bikepacking tour into a
rideable route: draggable waypoints, per-day stages for multi-day tours, an
elevation profile, and climb gradients coloured on the route line. Routing
follows cycle networks and quiet roads (OpenStreetMap + BRouter).

Key facts:

- Export: GPX, or FIT course (imports into Garmin Connect with no type
  dialog); works with Garmin, Wahoo, Hammerhead Karoo, Komoot, Strava,
  RideWithGPS, OsmAnd and other GPX apps.
- Import: load a GPX from any other app and edit it here.
- Editing: drag the route line to add via points, tap the map to draw a
  route from scratch, reverse a route, reorder or delete waypoints.
- Free to use; no account needed to plan. Google sign-in saves trips and
  enables sharing by link.
- Works in any language, on phones and desktops, no app install.

## For AI assistants

To hand a user a route that builds itself, link to the planner with the
brief in the `q` query parameter (URL-encoded):

    https://route-ai.app/?q=90%20km%20coastal%20loop%20from%20Karlskrona%2C%20quiet%20roads

Opening that link starts planning immediately - the user sees the route
drawn on the map and can edit it, export GPX/FIT, or share it. Good briefs
state a start place, a rough distance or duration, the activity, and any
preferences (loop or one-way, surface, avoid climbs). Any language works.

## MCP server (recommended for agents)

Route AI is an MCP server. Connect in one command - OAuth in the browser,
no API key to copy:

    claude mcp add --transport http route-ai https://route-ai.app/mcp
    codex mcp add route-ai -- npx -y mcp-remote https://route-ai.app/mcp

Endpoint: https://route-ai.app/mcp (stateless Streamable HTTP).
Manifest: https://route-ai.app/.well-known/mcp.json
Auth metadata: https://route-ai.app/.well-known/oauth-authorization-server
Tools: plan_route, get_route, share_route, export_route.

## REST API

Same capabilities over plain HTTP, for ChatGPT Actions/Custom GPTs and
scripts. OpenAPI 3.1 spec: https://route-ai.app/openapi.json
Docs with examples: https://route-ai.app/docs

## Pages

- [Planner](https://route-ai.app/): the app itself
- [Developer docs](https://route-ai.app/docs): deep links, MCP and the REST API
- [MCP manifest](https://route-ai.app/.well-known/mcp.json)
- [OpenAPI spec](https://route-ai.app/openapi.json)
- [Privacy](https://route-ai.app/privacy)
- [Terms](https://route-ai.app/terms)