# Multi-Stop Trip Planner

> Multi-Stop Trip Planner is a paid API for AI agents from agent402.tools, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Geocodes ordered stops, computes pairwise haversine distances, estimates arrival times per leg, and counts business days for a multi-stop journey plan.

## Facts

- Endpoint: POST https://agent402.tools/api/skill/trip-planner
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/multi-stop-trip-planner-e9e1615e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wEzYqDpQfTxfu50hdJP9K

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability multi-stop-trip-planner-e9e1615e -d '<json body>'
```

Example prompt: Plan my road trip starting July 20, 2026 at 8am UTC with stops in New York NY, Pittsburgh PA, Cleveland OH, and Chicago IL — give me the distances between each leg and estimated arrival times at each city.

## When to prefer this

Use this endpoint when you need a deterministic, structured multi-stop trip plan with distance calculations and arrival time estimates without relying on live traffic data. Ideal for logistics planning, itinerary generation, or any workflow where reproducible, formula-based travel estimates (haversine distances, constant driving speed assumptions) are sufficient over real-time routing APIs.

## Known failure modes

- Unrecognizable stop names fail geocoding — returns error indicating which stop could not be resolved
- Malformed ISO 8601 startIso causes a validation error
- Fewer than two stops provided returns an error as no leg can be computed
- Network timeout during geocoding of stops
- Invalid or missing stops field returns a schema validation error

## How this service works

Bundled execution of the Multi-stop trip planner workflow - Plan a multi-stop journey deterministically: geocode each stop, sum the pairwise haversine distances, estimate arrival times by adding driving hours per leg, count business days from today to each arrival, and pull the weather forecast at every US stop. Six tools - three pure-CPU (math + time), three egress (geocoding + weather) - covering the deterministic skeleton of every road-trip / sales-tour / delivery-route planning problem.

## Output

Returns geocoded coordinates for each stop, haversine distances for each leg between consecutive stops, total distance, estimated driving arrival times at each stop, and a count of business days from today for the journey.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "stops": {
   "type": "string",
   "description": "comma-separated ordered list of stops (e.g. 'New York NY, Pittsburgh PA, Cleveland OH, Chicago IL')"
  },
  "startIso": {
   "type": "string",
   "description": "trip start time as UTC ISO 8601 (e.g. '2026-07-20T08:00:00Z')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "args": {
   "stops": "New York NY, Pittsburgh PA, Cleveland OH, Chicago IL",
   "startIso": "2026-07-20T08:00:00Z"
  },
  "pack": "trip-planner",
  "steps": [
   {
    "ok": true,
    "slug": "geocode",
    "result": {}
   },
   {
    "ok": true,
    "slug": "geo-distance",
    "result": {}
   },
   {
    "ok": true,
    "slug": "add-time",
    "result": {}
   },
   {
    "ok": true,
    "slug": "business-days",
    "result": {}
   },
   {
    "ok": true,
    "slug": "time-convert",
    "result": {}
   },
   {
    "ok": true,
    "slug": "weather-forecast",
    "result": {}
   }
  ],
  "summary": "6/6 steps succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/multi-stop-trip-planner-e9e1615e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)