Evaluate a full trip (paid)
evaluate_tripPremium evaluation of a whole trip in one call: multiple passports (best passport per leg), documents held, multi-leg itineraries with transit legs, dates and purpose — with structured why[] explanations, conditions[], and verification states per decision. PAID endpoint: the call returns HTTP 402 x402 payment instructions unless the request carries an x402 payment header; any x402-capable client settles in USDC on Base and retries.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"traveler": "<traveler>",
"trip": "<trip>"
},
"name": "evaluate_trip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trip | Yes | The itinerary to evaluate, in travel order | |
| traveler | Yes | The traveler's documents |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| legs | No | One decision per leg: requirement, best_option (which held passport/document wins), why[] explanations with sources, conditions[] (validity, onward ticket, yellow fever, stay-duration fit), and a verification state | |
| error | No | Present on the unpaid path: 'payment_required' | |
| trip_summary | No | Aggregate outcome | |
| x402_requirements | No | x402 v2 payment requirements (decoded from the PAYMENT-REQUIRED header): pay in USDC on Base and retry the same call |