JustRouting MCP Server

JustRouting MCP

MCP server for JustRouting, a Southeast Asia-focused routing API.

Use JustRouting's road-routing capabilities from MCP-compatible AI assistants such as Claude and Cursor.

Features

• Driving route calculation
• Motorcycle routing profile
• Driving distance
• Estimated travel duration
• Distance and duration matrix (table)
• Address and place search (geocoding)
• Route optimization (vehicle routing)
• Southeast Asia-focused road coverage
• MCP stdio transport
• Built on the official JustRouting Go client

Requirements

• A JustRouting API key
• Go 1.25+ (only needed when installing from source)

Installation

One-line installer (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/justrouting/mcp/main/install.sh | sh

Downloads the latest prebuilt binary for your OS/architecture from GitHub Releases, verifies its checksum, and installs it to /usr/local/bin (or ~/.local/bin). No Go required.

Pin a specific version:

curl -fsSL https://raw.githubusercontent.com/justrouting/mcp/main/install.sh | JUSTROUTING_MCP_VERSION=v0.1.1 sh

Uninstall: remove the justrouting-mcp binary from the directory it was installed to.

Manual download

Prebuilt binaries for macOS, Linux, and Windows are attached to every release. Download the archive for your platform, extract it, and put the binary on your PATH.

From source (Go users)

go install github.com/justrouting/mcp/cmd/justrouting-mcp@latest

Make sure justrouting-mcp is available in your PATH.

Configuration

Set your JustRouting API key:

export JUSTROUTING_API_KEY="YOUR-API-KEY"

Tools

route

Calculate a route between two locations, using the driving profile by default or the motorcycle profile when requested.

Input:

{
  "origin": "103.8198,1.3521",
  "destination": "103.9915,1.3644",
  "profile": "motorcycle"
}

profile is optional. Set it to "motorcycle" for a motorcycle route; omit it (or use "car") for the default driving route. When the user mentions a motorcycle or motorbike, the assistant sets profile to "motorcycle".

Coordinates must use:

longitude,latitude

If the user asks about places by name or address instead of coordinates, call geocode first (see below) and pass its coordinates values here.

Output:

{
  "distance_meters": 18500,
  "duration_seconds": 1500
}

distance_meters is the driving distance in meters.

duration_seconds is the estimated driving duration in seconds.

geocode

Search for places and convert a place name or address into coordinates. Use this before route when the user refers to places by name.

The search is structured: the assistant parses the user's place reference into address components and passes only the ones it can determine — name, housenumber, street, postcode, city, country. Components with no data are omitted. Prefer including country (and city) when the context implies them — they are the strongest disambiguators for common, abbreviated, or misspelled names.

Input:

Shortened. The full README is on GitHub.