Skip to main content

​
JustRouting MCP

JustRouting MCP lets AI assistants such as Claude and Cursor use JustRouting for road routing, geocoding, distance and travel-time comparison, and multi-vehicle route optimization. Designed for Southeast Asia.

​
What you can do

The tools are designed around three simple tasks:
  • route — calculate
  • table — compare
  • optimize — decide

​
Installation

​
One-line installer

On macOS or Linux:
The installer downloads the latest prebuilt binary for your OS and architecture, verifies its checksum, and installs justrouting-mcp. To install a specific version:
No Go installation is required.

​
From source

If you have Go installed:
Requires Go 1.25+. Make sure justrouting-mcp is available in your PATH. Prebuilt binaries for supported platforms are also available from GitHub Releases.

​
Configuration

The server reads the JustRouting API key from the JUSTROUTING_API_KEY environment variable:
You can get an API key from JustRouting.

​
Which tool should I use?

Use the simplest tool that matches the user’s task: A simple rule:
  • One route → route
  • Many routes to compare → table
  • Many jobs to assign and order → optimize
  • Place name or address → geocode first

​
Tools

Geocode

Convert a place name or address into coordinates.

Route

Calculate one route between two locations.

Table

Compare travel times or distances between multiple locations.

Optimize

Assign jobs to vehicles and order their stops.

​
Agent workflows

JustRouting MCP is designed so that AI assistants can combine the tools into larger workflows.

​
Route between two places

For:
How long does it take to drive from Marina Bay Sands to Changi Airport?
Use:
  1. Geocode the origin.
  2. Geocode the destination.
  3. Verify the selected results match the intended places.
  4. Pass their coordinates values to route.
If the user already provides coordinates, skip geocoding.

​
Find the nearest driver

For:
Which driver is closest to this customer?
Use:
  1. Geocode the customer.
  2. Geocode each driver.
  3. Keep the locations in a fixed order.
  4. Put the customer in sources.
  5. Put the drivers in destinations.
  6. Compare the corresponding distance or duration values.
  7. Ignore unreachable null values.

​
Plan multiple vehicles

For:
I have two vans and six customers. Assign the customers to the vans and determine the stop order.
Use:
  1. Geocode each vehicle’s start/end location.
  2. Geocode every job location.
  3. Create one vehicle entry per vehicle.
  4. Create one job entry per customer.
  5. Call optimize.
  6. Read routes[].steps to determine each vehicle’s itinerary.
  7. Check unassigned for jobs that could not be served.

​
Coordinate format

All routing tools use:
For example:
This means:
Do not reverse the order.

​
Claude

​
Claude Code

Add JustRouting MCP with:

​
Claude Desktop

Add the server to claude_desktop_config.json:
Restart Claude Desktop after changing the configuration.

​
Cursor

Add JustRouting MCP from Settings → MCP → Add new MCP server. Use:
Once connected, Cursor can use the JustRouting tools directly.