luisbretasjr avatar

Routekit

luisbretasjr/routekit-mcp

RouteKit is a logistics toolbox built specifically for Brazil. It gives Claude access to real road routing, distance matrices for up to 5,000 locations, and a full VRP solver that handles time windows, multi-dimensional capacity, pickup-delivery pairs, and mixed vehicle profiles. You also get geocoding, reverse geocoding, snap-to-road, and isochrone tools, all using in-house data with no third-party dependencies. The optimizer supports per-vehicle cost models, technician skill matching, and different balance strategies. Useful when you're building delivery schedules, field service routes, or coverage analysis for Brazilian operations. Offers both stdio and direct HTTP transports, with a free tier at 50 calls per month.

tools
10
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Apr 14, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

calculate_routeDriving route between points with real road distances and ETAs. Supports waypoints, encoded polyline geometry, turn-by-turn steps, and up to 3 alternative routes.

Driving route between points with real road distances and ETAs. Supports waypoints, encoded polyline geometry, turn-by-turn steps, and up to 3 alternative routes.

No parameter schema in public metadata yet.

distance_matrixNxN distance/duration matrix between up to 5000 locations (transparently chunked for large sets, cached for repeated queries).

NxN distance/duration matrix between up to 5000 locations (transparently chunked for large sets, cached for repeated queries).

No parameter schema in public metadata yet.

snap_to_roadSnap a raw GPS coordinate to the nearest road segment. Returns the snapped point, distance from the original, and road name.

Snap a raw GPS coordinate to the nearest road segment. Returns the snapped point, distance from the original, and road name.

No parameter schema in public metadata yet.

isochroneArea reachable from a point within N minutes by car. Returns a GeoJSON Polygon useful for coverage analysis, depot placement, and service area definition.

Area reachable from a point within N minutes by car. Returns a GeoJSON Polygon useful for coverage analysis, depot placement, and service area definition.

No parameter schema in public metadata yet.

geocodeConvert a Brazilian address or place name to latitude/longitude. Restricted to Brazil, in-house geocoder with no third-party dependency.

Convert a Brazilian address or place name to latitude/longitude. Restricted to Brazil, in-house geocoder with no third-party dependency.

No parameter schema in public metadata yet.

geocode_batchGeocode up to 50 addresses in a single call with parallel execution. Perfect for delivery manifests or client lists.

Geocode up to 50 addresses in a single call with parallel execution. Perfect for delivery manifests or client lists.

No parameter schema in public metadata yet.

reverse_geocodeConvert lat/lon to a human-readable Brazilian address with components (road, neighborhood, city, state, postcode).

Convert lat/lon to a human-readable Brazilian address with components (road, neighborhood, city, state, postcode).

No parameter schema in public metadata yet.

compare_routesRun `optimize_routes` under multiple balance strategies (minimize_vehicles, balance_tasks, minimize_distance) and return a side-by-side comparison with winners per metric.

Run `optimize_routes` under multiple balance strategies (minimize_vehicles, balance_tasks, minimize_distance) and return a side-by-side comparison with winners per metric.

No parameter schema in public metadata yet.

validate_etaSimulate a pre-defined route in Python and return the real arrival times plus any constraint violations. Use when you already have a fixed order of stops and just need the ETAs.

Simulate a pre-defined route in Python and return the real arrival times plus any constraint violations. Use when you already have a fixed order of stops and just need the ETAs.

No parameter schema in public metadata yet.

optimize_routesAdvanced VRP solver with tasks and/or shipments, constraints (time windows, skills, capacity, breaks, priorities), per-vehicle costs, balance modes, and optional route geometry.

Advanced VRP solver with tasks and/or shipments, constraints (time windows, skills, capacity, breaks, priorities), per-vehicle costs, balance modes, and optional route geometry.

No parameter schema in public metadata yet.

Sponsors

Configuration

ROUTEKIT_API_KEY*secret

Your RouteKit API key. Get one free at https://routekit.nexterait.com.br/static/signup.html

Readme

RouteKit MCP

Route optimization API for Brazil. First MCP server for route optimization.

Install

npx routekit-mcp

Or configure in your MCP client:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "routekit": {
      "command": "npx",
      "args": ["-y", "routekit-mcp"],
      "env": {
        "ROUTEKIT_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Direct HTTP (no install needed)

{
  "mcpServers": {
    "routekit": {
      "type": "url",
      "url": "https://routekit.nexterait.com.br/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

Get API Key

Get a free key (50 calls/month) at routekit.nexterait.com.br/static/signup.html

Tools


View the full README on GitHub

Details

Repository
github.com/luisbretasjr/routekit-mcp
Package
routekit-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active