OSRMRoute MCP Server

Give your AI agents location superpowers. This Model Context Protocol server exposes the OSRMRoute maps & routing platform as tools any MCP client (Claude Desktop, Cursor, Cline, …) can call.

Strong coverage of Azerbaijan, the Caucasus, Central Asia, Turkey and the Middle East — on our own OpenStreetMap servers, at a fraction of the cost of global providers.

Tools

| Tool | What it does | |------|--------------| | geocode_address | Address / place name → coordinates | | reverse_geocode | Coordinates → nearest address | | autocomplete_address | Partial text → ranked address suggestions | | get_route | Driving/cycling/walking route with distance, time & geometry | | distance_matrix | Time & distance between every pair of points | | get_isochrone | Reachable area within a time budget | | optimize_route | Multi-stop / multi-vehicle route optimization (VRP) | | get_timezone | Timezone & UTC offset for a coordinate |

Coordinate arrays use [lon, lat] order (longitude first), matching the OSRMRoute API.

Setup

1. Get an API key at https://osrmroute.com/dashboard.
2. Add the server to your MCP client config.

Claude Desktop / Cursor

{
  "mcpServers": {
    "osrmroute": {
      "command": "npx",
      "args": ["-y", "osrmroute-mcp"],
      "env": {
        "OSRMROUTE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Or install globally and point at the binary:

npm install -g osrmroute-mcp

{
  "mcpServers": {
    "osrmroute": {
      "command": "osrmroute-mcp",
      "env": { "OSRMROUTE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Environment variables

| Var | Required | Default | Notes | |-----|----------|---------|-------| | OSRMROUTE_API_KEY | ✅ | — | Your key from the dashboard | | OSRMROUTE_BASE_URL | — | https://osrmroute.com | Override for self-hosted / staging |

Local development

cd mcp-server
npm install
OSRMROUTE_API_KEY=your_key node index.mjs

Usage counts against your OSRMRoute plan, just like direct API calls.

License

MIT · © MAMMADOFF AGENCY LLC