Paid Route & Delivery Optimisation API via x402. Unpaid tool calls return 402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Estimate bookable orders per zone and time slot from vehicle time, service, drive and stem assumptions. Price $0.02 USDC. POST /api/v1/route-optimization/delivery-slot-capacity. An unpaid call returns the x402 payment terms and does not run.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http route-optimization https://www.brainiac.software/mcp/route-optimization
Estimate bookable orders per zone and time slot from vehicle time, service, drive and stem assumptions. Price $0.02 USDC. POST /api/v1/route-optimization/delivery-slot-capacity. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| slots* | array | |
| zones* | array | |
| booked | array | |
| bufferPct | number | |
| stemEverySlot | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"zones",
"slots"
],
"properties": {
"slots": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"start",
"end"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"end": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"start": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
}
}
},
"maxItems": 100,
"minItems": 1
},
"zones": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"vehicles",
"avgServiceMin",
"avgDriveBetweenStopsMin"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"stemMin": {
"type": "number",
"minimum": 0
},
"vehicles": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"avgServiceMin": {
"type": "number",
"minimum": 0
},
"avgDriveBetweenStopsMin": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 500,
"minItems": 1
},
"booked": {
"type": "array",
"items": {
"type": "object",
"required": [
"zone",
"slot",
"orders"
],
"properties": {
"slot": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"zone": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"orders": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"maxItems": 50000
},
"bufferPct": {
"type": "number",
"maximum": 0.9,
"minimum": 0
},
"stemEverySlot": {
"type": "boolean"
}
}
}Choose p hub locations from candidates to minimise demand-weighted distance, optionally capacitated. Price $0.04 USDC. POST /api/v1/route-optimization/depot-location-optimize. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| p* | integer | |
| demand* | array | |
| matrix | object | |
| candidates* | array | |
| capacities | any | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"demand",
"candidates",
"p"
],
"properties": {
"p": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"demand": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"weight"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"weight": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 20000,
"minItems": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 500,
"minItems": 1
},
"capacities": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
}
},
{
"type": "null"
}
]
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Build a haversine distance and estimated duration matrix from caller coordinates with optional circuity and speed. Price $0.02 USDC. POST /api/v1/route-optimization/distance-matrix. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| circuity | number | |
| speedKph | number | |
| speedMps | number | |
| locations* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"locations"
],
"properties": {
"circuity": {
"type": "number",
"maximum": 3,
"minimum": 1
},
"speedKph": {
"type": "number",
"exclusiveMinimum": 0
},
"speedMps": {
"type": "number",
"exclusiveMinimum": 0
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"lat",
"lon"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 500,
"minItems": 1
}
}
}Assign pre-built routes to drivers by shift, skills and vehicle type with min-cost Hungarian matching. Price $0.03 USDC. POST /api/v1/route-optimization/driver-shift-assign. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| routes* | array | |
| drivers* | array | |
| skillMode | string | |
| skillPenalty | number | |
| allowMultiple | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"routes",
"drivers"
],
"properties": {
"routes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"start",
"end"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"end": {
"type": "number"
},
"start": {
"type": "number"
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 50
},
"vehicleType": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
}
},
"maxItems": 500,
"minItems": 1
},
"drivers": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"shift"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"cost": {
"type": "number",
"minimum": 0
},
"shift": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 50
},
"vehicleTypes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 50
}
}
},
"maxItems": 500,
"minItems": 1
},
"skillMode": {
"enum": [
"strict",
"soft"
],
"type": "string"
},
"skillPenalty": {
"type": "number",
"minimum": 0
},
"allowMultiple": {
"type": "boolean"
}
}
}Test points against GeoJSON service zones with holes, reporting inside/in-hole status and nearest boundary distance. Price $0.02 USDC. POST /api/v1/route-optimization/geofence-check. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| zones* | object | |
| points* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"zones",
"points"
],
"properties": {
"zones": {
"type": "object",
"required": [
"type",
"features"
],
"properties": {
"type": {
"type": "string",
"const": "FeatureCollection"
},
"features": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"geometry"
],
"properties": {
"type": {
"type": "string",
"const": "Feature"
},
"geometry": {
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"enum": [
"Polygon",
"MultiPolygon"
],
"type": "string"
},
"coordinates": {
"type": "array",
"items": {}
}
}
},
"properties": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"maxItems": 1000,
"minItems": 1
}
}
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"lon",
"lat"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 10000,
"minItems": 1
}
}
}Assign recurring visits across a horizon with frequency and spacing rules, then route each day. Price $0.05 USDC. POST /api/v1/route-optimization/multi-day-plan. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| depot* | object | |
| stops* | array | |
| matrix | object | |
| horizonDays* | array | |
| timeLimitMs | integer | |
| capacityPerDay | any | |
| vehiclesPerDay | integer | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"horizonDays",
"stops",
"depot"
],
"properties": {
"depot": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"visitsPerWeek"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"demand": {
"type": "number",
"minimum": 0
},
"minGapDays": {
"type": "integer",
"maximum": 28,
"minimum": 0
},
"allowedDays": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
{
"type": "null"
}
]
},
"visitsPerWeek": {
"type": "integer",
"maximum": 28,
"minimum": 1
}
}
},
"maxItems": 2000,
"minItems": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"horizonDays": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 28,
"minItems": 1
},
"timeLimitMs": {
"type": "integer",
"maximum": 25000,
"minimum": 1
},
"capacityPerDay": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"vehiclesPerDay": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Route paired pickup-and-delivery requests with precedence, same-vehicle and capacity constraints. Price $0.05 USDC. POST /api/v1/route-optimization/pickup-delivery. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| depot* | object | |
| speed | number | |
| matrix | object | |
| circuity | number | |
| requests* | array | |
| vehicles* | array | |
| timeLimitMs | integer | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"depot",
"requests",
"vehicles"
],
"properties": {
"depot": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"circuity": {
"type": "number",
"maximum": 3,
"minimum": 1
},
"requests": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"pickup",
"delivery",
"quantity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"pickup": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"delivery": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"quantity": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
},
"vehicles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"capacity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"capacity": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 100,
"minItems": 1
},
"timeLimitMs": {
"type": "integer",
"maximum": 25000,
"minimum": 1
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Encode or decode Google Encoded Polyline strings and optionally simplify with Douglas-Peucker. Price $0.01 USDC. POST /api/v1/route-optimization/polyline-codec. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| decode | any | |
| encode | array | |
| simplify | any | |
| precision | any |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"decode": {
"anyOf": [
{
"type": "string",
"maxLength": 1000000
},
{
"type": "null"
}
]
},
"encode": {
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"maxItems": 100000,
"minItems": 1
},
"simplify": {
"anyOf": [
{
"type": "object",
"properties": {
"tolerance": {
"type": "number",
"exclusiveMinimum": 0
},
"toleranceM": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
{
"type": "null"
}
]
},
"precision": {
"anyOf": [
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 6
}
]
}
}
}Compute arrivals, waits, slack and overtime for a fixed stop sequence with optional return and shift end. Price $0.02 USDC. POST /api/v1/route-optimization/route-eta-schedule. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| speed | number | |
| start* | object | |
| matrix | object | |
| returnTo | object | |
| sequence* | array | |
| shiftEnd | number | |
| speedMps | number | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"start",
"sequence"
],
"properties": {
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"start": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"time": {
"type": "number"
}
}
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"returnTo": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"sequence": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"service": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
},
"shiftEnd": {
"type": "number"
},
"speedMps": {
"type": "number",
"exclusiveMinimum": 0
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Check a manual plan for time-window, capacity, shift, precedence and duplicate/missing-stop violations. Price $0.02 USDC. POST /api/v1/route-optimization/route-plan-validate. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| plan* | array | |
| depot | object | |
| speed | number | |
| stops* | array | |
| matrix | object | |
| requests | array | |
| vehicles* | array | |
| requireAllStops | boolean | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stops",
"vehicles",
"plan"
],
"properties": {
"plan": {
"type": "array",
"items": {
"type": "object",
"required": [
"vehicle",
"sequence"
],
"properties": {
"vehicle": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"sequence": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 2000,
"minItems": 1
}
}
},
"maxItems": 100,
"minItems": 1
},
"depot": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
}
}
},
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"demand": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
},
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"service": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"requests": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"pickup",
"delivery",
"quantity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"pickup": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"delivery": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"quantity": {
"type": "number",
"minimum": 0
}
}
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"shift": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"breaks": {
"type": "array",
"items": {
"type": "object",
"required": [
"window",
"duration"
],
"properties": {
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"duration": {
"type": "number",
"minimum": 0
}
}
}
},
"capacity": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
}
}
},
"maxItems": 100,
"minItems": 1
},
"requireAllStops": {
"type": "boolean"
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Split stops into k balanced, compact territories with capacitated k-means and imbalance limits. Price $0.03 USDC. POST /api/v1/route-optimization/territory-cluster. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| k* | integer | |
| seed | integer | |
| stops* | array | |
| balanceBy | string | |
| maxImbalance | number | |
| matrixFromPoints | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stops",
"k"
],
"properties": {
"k": {
"type": "integer",
"maximum": 500,
"minimum": 1
},
"seed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"weight": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
},
"balanceBy": {
"enum": [
"count",
"weight"
],
"type": "string"
},
"maxImbalance": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}Find a best visiting order for one vehicle (closed tour or open path) with fixed start and optional fixed end using Held-Karp or local search. Price $0.05 USDC. POST /api/v1/route-optimization/tsp-optimize. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| end | any | |
| speed | number | |
| start* | string | |
| matrix | object | |
| circuity | number | |
| speedMps | number | |
| locations* | array | |
| objective | string | |
| timeLimitMs | integer | |
| matrixFromPoints | string |
Order parcels last-delivered-first and run a deterministic layer first-fit packing check in a van or truck box. Price $0.03 USDC. POST /api/v1/route-optimization/vehicle-load-sequence. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| box* | object | |
| units | string | |
| parcels* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"box",
"parcels"
],
"properties": {
"box": {
"type": "object",
"required": [
"length",
"width",
"height",
"maxWeight"
],
"properties": {
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
},
"length": {
"type": "number",
"exclusiveMinimum": 0
},
"maxWeight": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"units": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"parcels": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"stopIndex",
"l",
"w",
"h",
"weight"
],
"properties": {
"h": {
"type": "number",
"exclusiveMinimum": 0
},
"l": {
"type": "number",
"exclusiveMinimum": 0
},
"w": {
"type": "number",
"exclusiveMinimum": 0
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"weight": {
"type": "number",
"minimum": 0
},
"rotatable": {
"type": "boolean"
},
"stopIndex": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
}
}
}Assign stops to vehicles under capacity (and optional duration) limits, returning routes with loads and distances. Price $0.05 USDC. POST /api/v1/route-optimization/vrp-capacitated. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| depot* | object | |
| speed | number | |
| stops* | array | |
| matrix | object | |
| circuity | number | |
| minimise | string | |
| speedMps | number | |
| vehicles* | array | |
| timeLimitMs | integer | |
| matrixFromPoints | string | |
| maxRouteDuration |
Route stops under customer time windows, service times, driver shifts and breaks with forward time propagation. Price $0.05 USDC. POST /api/v1/route-optimization/vrp-time-windows. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| depot* | object | |
| speed | number | |
| stops* | array | |
| matrix | object | |
| circuity | number | |
| minimise | string | |
| speedMps | number | |
| vehicles* | array | |
| timeLimitMs | integer | |
| matrixFromPoints | string |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"locations",
"start"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string",
"maxLength": 120,
"minLength": 1
},
{
"type": "null"
}
]
},
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"circuity": {
"type": "number",
"maximum": 3,
"minimum": 1
},
"speedMps": {
"type": "number",
"exclusiveMinimum": 0
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"maxItems": 2000,
"minItems": 2
},
"objective": {
"enum": [
"distance",
"duration"
],
"type": "string"
},
"timeLimitMs": {
"type": "integer",
"maximum": 25000,
"minimum": 1
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}| any |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"depot",
"stops",
"vehicles"
],
"properties": {
"depot": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"demand"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"demand": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
}
}
},
"maxItems": 2000,
"minItems": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"circuity": {
"type": "number",
"maximum": 3,
"minimum": 1
},
"minimise": {
"enum": [
"distance",
"duration"
],
"type": "string"
},
"speedMps": {
"type": "number",
"exclusiveMinimum": 0
},
"vehicles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"capacity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"end": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"start": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
},
"capacity": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
}
}
},
"maxItems": 100,
"minItems": 1
},
"timeLimitMs": {
"type": "integer",
"maximum": 25000,
"minimum": 1
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
},
"maxRouteDuration": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"depot",
"stops",
"vehicles"
],
"properties": {
"depot": {
"type": "object",
"required": [
"id"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
}
}
},
"speed": {
"type": "number",
"exclusiveMinimum": 0
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"window"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"demand": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
},
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"service": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 2000,
"minItems": 1
},
"matrix": {
"type": "object",
"required": [
"distances"
],
"properties": {
"distances": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
},
"durations": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
}
},
"maxItems": 2000,
"minItems": 1
}
}
},
"circuity": {
"type": "number",
"maximum": 3,
"minimum": 1
},
"minimise": {
"enum": [
"distance",
"completion_time",
"vehicles"
],
"type": "string"
},
"speedMps": {
"type": "number",
"exclusiveMinimum": 0
},
"vehicles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"shift"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"shift": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"breaks": {
"type": "array",
"items": {
"type": "object",
"required": [
"window",
"duration"
],
"properties": {
"window": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"duration": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 20
},
"capacity": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 8,
"minItems": 1
}
]
}
}
},
"maxItems": 100,
"minItems": 1
},
"timeLimitMs": {
"type": "integer",
"maximum": 25000,
"minimum": 1
},
"matrixFromPoints": {
"enum": [
"euclidean",
"haversine"
],
"type": "string"
}
}
}