Route optimization API for Brazil. Routes, distance matrices, and VRP solver.
Route optimization API for Brazil. Routes, distance matrices, and VRP solver. The routekit mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.
Everything the assistant can do here goes through one of these:
calculate_route — - Driving route between points with real road distances and ETAs. Supports waypoints, encoded polyline geometry, turn-by-turn steps, and up to 3distance_matrix — - NxN distance/duration matrix between up to 5000 locations (transparently chunked for large sets, cached for repeated queries)snap_to_road — - Snap a raw GPS coordinate to the nearest road segment. Returns the snapped point, distance from the original, and road nameisochrone — - Area reachable from a point within N minutes by car. Returns a GeoJSON Polygon useful for coverage analysis, depot placement, and service areageocode — - Convert a Brazilian address or place name to latitude/longitude. Restricted to Brazil, in-house geocoder with no third-party dependency. Built-ingeocode_batch — - Geocode up to 50 addresses in a single call with parallel execution. Perfect for delivery manifests or client listsreverse_geocode — - Convert lat/lon to a human-readable Brazilian address with components (road, neighborhood, city, state, postcode)compare_routes — - Run optimize_routes under multiple balance strategies (minimize_vehicles, balance_tasks, minimize_distance) and return a side-by-side comparisonvalidate_eta — - 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 ofoptimize_routes — - Advanced VRP solver:Constraints — time windows (multiple per task), skills, multi-dimensional capacity, breaks, prioritiesPer — vehicle costs (fixed, per_hour, per_km, per_task_hour), max_tasks, max_travel_time_min, max_distance_kmInstallation goes through your MCP client rather than a global install: point it at routekit-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
You will need 2 environment variables: ROUTEKIT_API_KEY, YOUR_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Routekit's toolset — calculate_route, distance_matrix, snap_to_road and 11 more — is a fair guide to whether it matches your workflow. It is maintained by luisbretasjr; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| calculate_route | - 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. |
| distance_matrix | - NxN distance/duration matrix between up to 5000 locations (transparently chunked for large sets, cached for repeated queries). |
| snap_to_road | - Snap a raw GPS coordinate to the nearest road segment. Returns the snapped point, distance from the original, and road name. |
| isochrone | - Area reachable from a point within N minutes by car. Returns a GeoJSON Polygon useful for coverage analysis, depot placement, and service area definition. |
| geocode | - Convert a Brazilian address or place name to latitude/longitude. Restricted to Brazil, in-house geocoder with no third-party dependency. Built-in fuzzy fallback handles abbreviations ("Av" -> "Avenida"), accents, and t |
| geocode_batch | - Geocode up to 50 addresses in a single call with parallel execution. Perfect for delivery manifests or client lists. |
| reverse_geocode | - Convert lat/lon to a human-readable Brazilian address with components (road, neighborhood, city, state, postcode). |
| compare_routes | - Run optimize_routes under multiple balance strategies (minimize_vehicles, balance_tasks, minimize_distance) and return a side-by-side comparison with winners per metric. |
| validate_eta | - 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. |
| optimize_routes | - Advanced VRP solver: |
| Constraints | time windows (multiple per task), skills, multi-dimensional capacity, breaks, priorities |
| Per | vehicle costs (fixed, per_hour, per_km, per_task_hour), max_tasks, max_travel_time_min, max_distance_km |
| balance_mode | minimize_vehicles (default), balance_tasks, or minimize_distance |
| Mixed | profile fleets (car / bike / foot) with per-vehicle profile |
### Direct HTTP (no install needed)
```json
{
"mcpServers": {
"routekit": {
"type": "url",
"url": "https://routekit.nexterait.com.br/mcp",
"headers": {
"X-API-Key": "YOUR_KEY"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| ROUTEKIT_API_KEY | Credential the server authenticates with. | Yes |
| YOUR_KEY | Credential the server authenticates with. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.