Skip to main content
Glama

πŸ—ΊοΈ OpenRoute MCP

PyPI - Version PyPI - Python Version Tests MCP registry

Model Context Protocol (MCP) server to plan routes using the OpenRouteService API, for activities such as hiking or mountain biking.

CAUTION

DISCLAIMER: The routes generated by this service are provided for informational purposes only and are not guaranteed to be safe, legal, or suitable for your intended use. Always verify routes independently using official maps, local authorities, and current conditions before attempting any journey. Users assume all risks and responsibilities for their safety and compliance with local laws and regulations.

TIP

Copy the whole GPX file returned as part of the tool call results, and use a service such as gpx.studio to load the generated GPX file on a map.

πŸ› οΈ Available tools

  • πŸ“ Find possible coordinates for a location

    • Arguments:

      • location (string): location to get coordinates for

    • Returns: list of 10 coordinates with available description to enable the agent figure out the right one

  • 🏠 Find possible locations (addresses) for given coordinates.

    • Arguments:

      • lon (float): Longitude of the location

      • lat (float): Latitude of the location

    • Returns: list of objects close to the given coordinates

  • πŸ—ΊοΈ Create a route from a starting location to a destination, optionally with waypoints

    • Arguments:

      • route_type (string): Type of route, e.g. "cycling-mountain", "cycling-regular", "foot-hiking", "driving-car"

      • from_coordinates (list[float]): Starting location as [longitude, latitude]

      • from_coordinates (list[float]): Destination location as [longitude, latitude]

      • waypoints (list[list[float]]): optional list of waypoints coordinates as [[lon, lat], ...]

    • Returns:

      • a resource file containing the route GPX (e.g. route://foot-hiking-98.gpx)

      • a resource file containing a PNG image visualization of the route (e.g. route://foot-hiking-98.png)

      • a resource file containing a HTML interactive visualization of the route (e.g. ui://foot-hiking-98.html) that can be directly opened with your browser

  • πŸ“Œ Search for Points of Interest (POIs) in an area

    • Arguments:

      • bounding_box_coordinates (list[list[float]]): coordinates defining a bounding box as [[min_lon, min_lat], [max_lon, max_lat]]

      • filters_name (list[string]): optional list of names to filter POIs, e.g. ["Gas station", "Restaurant"]

    • Returns: found POIs information

  • πŸ”Ž Search for known routes close to a given start and end coordinates, this enables to suggest waypoints to go through known trails when creating a route. It is only working in Switzerland for now thanks to the Swiss Confederation api3.geo.admin.ch πŸ‡¨πŸ‡­

    • Arguments:

      • route_type (string): Type of route, e.g. "cycling-mountain", "cycling-regular", "foot-hiking", "driving-car"

      • from_coordinates (list[float]): Starting location as [longitude, latitude]

      • from_coordinates (list[float]): Destination location as [longitude, latitude]

    • Returns: known trails trace and description when available to help the agent build a nice route

  • ⏱️ Computes the area that can be reached within a given time or distance from one or more starting points.

    • Arguments:

      • coordinates_list: 1 or more coordinates to compute reachable area from as [[lon, lat], ...]

      • route_type: Type of route, e.g. "cycling-mountain", "cycling-regular", "foot-hiking", "driving-car"

      • range_type: Type of range, either time (in seconds) or distance (in metres)

      • area_range: maximum range value of the analysis in seconds for time and metres for distance. Or a comma separated list of specific range values

    • Returns: Reachable area information in GeoJSON format

Related MCP server: maps-mcp-server

πŸ—ƒοΈ Available Resources

  • 🚏 Route files

    • URL pattern: route://{filename}

    • Type: GPX (.gpx), HTML (.html), or PNG (.png)

    • Description: Returns a previously generated route file by filename.

    • Produced by: create_route_from_to tool

πŸ”Œ Connect client to MCP server

Follow the instructions of your client, and use the /mcp URL of your deployed server (e.g. http://localhost:8888/mcp)

For example, for GitHub Copilot in VSCode, to add a new MCP server through the VSCode UI:

  • Open side panel chat (ctrl+shift+i or cmd+shift+i), and make sure the mode is set to Agent in the bottom right

  • Open command palette (ctrl+shift+p or cmd+shift+p), and search for MCP: Open User Configuration, this will open a mcp.json file

⌨️ Use stdio transport

IMPORTANT

Login with GitHub to openrouteservice.org and get an API key that you can provide through the OPENROUTESERVICE_API_KEY environment variable.

OPENROUTESERVICE_API_KEY=YYY uvx openroute-mcp

In VSCode mcp.json file you should have:

{
  "servers": {
    "openroute-mcp": {
      "command": "uvx",
      "args": [
        "openroute-mcp"
      ],
      "env": {
        "OPENROUTESERVICE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
IMPORTANT

Click on Start just on top of "openroute-mcp" to start the connection to the MCP server.

You can click the wrench and screwdriver button πŸ› οΈ (Configure Tools...) to enable/disable specific tools

Full details of the CLI options:

usage: openroute-mcp [-h] [--http] [--port PORT] [--openroute-api OPENROUTE_API] [--openroute-api-key OPENROUTE_API_KEY]
                     [--data-folder DATA_FOLDER] [--no-save] [--no-img] [--no-html]

A Model Context Protocol (MCP) server for building routes using OpenRouteService.

options:
  -h, --help            show this help message and exit
  --http                Use Streamable HTTP transport
  --port PORT           Port to run the server on
  --openroute-api OPENROUTE_API
                        OpenRouteService API URL (default: https://api.openrouteservice.org)
  --openroute-api-key OPENROUTE_API_KEY
                        OpenRouteService API key (default: taken from env var OPENROUTESERVICE_API_KEY)
  --data-folder DATA_FOLDER
                        Folder to save generated routes
  --no-save             Don't save generated routes to disk (also disable image and HTML generation)
  --no-img              Do not add PNG image visualization of the routes to the response (image not supported by all LLMs)
  --no-html            Do not add HTML interactive map for routes to the response

πŸ§‘β€πŸ’» Development

Checkout the CONTRIBUTING.md page for more details on running in development and contributing.

Available Tools

6 tools
create_route_from_toA

Create a route from a starting location coordinates to a destination, optionally with waypoints.

Args: route_type: Type of route, e.g. "driving-car", "cycling-mountain", "cycling-regular", "foot-hiking" from_coordinates: Starting location as [longitude, latitude] to_coordinates: Destination location as [longitude, latitude] waypoints: optional list of waypoints coordinates as [[lon, lat], ...]

Returns: GPX representation of the route

Inputs: route_type (required), from_coordinates (required), to_coordinates (required), waypoints. Returns: result

get_coordinates_objectC

Returns the next enclosing objects with an address tag which surrounds the given coordinate.

Args: lon: Longitude of the location lat: Latitude of the location

Returns: List of objects results close to the given coordinates

Inputs: lon (required), lat (required). Returns: results

get_reachable_areaA

Computes the area that can be reached within a given time or distance from one or more starting points.

Args: coordinates_list: 1 or more coordinates to compute reachable area from as [[lon, lat], ...] route_type: Type of route, e.g. "cycling-mountain", "cycling-regular", "foot-hiking", "driving-car" range_type: Type of range, either time (in seconds) or distance (in metres) area_range: maximum range value of the analysis in seconds for time and metres for distance. Or a comma separated list of specific range values

Returns: Reachable area information in GeoJSON format

Inputs: coordinates_list (required), route_type (required), range_type (required), area_range. Returns: type, bbox, features, information

search_known_routesA

Search for known hiking/cycling routes close to a given start and end coordinates, this enables to suggest waypoints to go through known trails when creating a route.

Currently only works for Switzerland using Swiss Geo API.

Args: route_type: Type of route, e.g. "driving-car", "cycling-mountain", "cycling-regular", "foot-hiking" from_coordinates: Starting location as [longitude, latitude] to_coordinates: Destination location as [longitude, latitude]

Returns: Description of known routes close to the given coordinates

Inputs: route_type (required), from_coordinates (required), to_coordinates (required). Returns: result

search_location_coordinatesA

Search for possible coordinates of a location.

Args: location: Location string (address or place name)

Returns: List of location results with coordinates, address, and metadata.

Inputs: location (required). Returns: results

search_poisB

Search for points of interest (POIs) in an area.

Args: bounding_box_coordinates: coordinates defining a bounding box as [[min_lon, min_lat], [max_lon, max_lat]] filters_name: optional explictly mentioned list of names to filter POIs, e.g. ["Gas station", "Restaurant"]

Returns: Found POIs information

Inputs: bounding_box_coordinates (required), filters_name. Returns: type, bbox, features, information

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: route creation, reverse geocoding, isochrone analysis, known route discovery, forward geocoding, and POI search. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (create_route_from_to, get_coordinates_object, get_reachable_area, search_known_routes, search_location_coordinates, search_pois) using snake_case. The pattern is uniform and predictable.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a routing and location utility. Each tool addresses a fundamental need without unnecessary redundancy or excessive features.

    Completeness4/5

    The tool set covers core routing, geocoding, reverse geocoding, isochrones, and POI search. Minor gaps exist, such as lack of distance matrix or turn-by-turn directions, but overall it provides a solid base for location-based tasks.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server providing 30 tools for geocoding, routing, and OpenStreetMap data analysis. It enables AI assistants to search for locations, calculate travel routes, and perform quality assurance checks on map data.
      30
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for geocoding, reverse geocoding, place/POI search, and distance calculation using OpenStreetMap Nominatim, with no API key required.
      87 npm
      1
      MIT