Skip to content
NEMT MCP Service

review_trip

Status: Verified | Module: booking

Generate a formatted summary of all booking details for the agent to read back to the member. MUST be called before confirm_trip (sets draft.LastStep = "review" — the sequence gate confirm_trip checks).

Works for both one-time trips AND recurring standing orders — when trip_type=standing_order, the summary also shows the schedule (days, dates, time). If required fields are missing, returns ready_to_confirm=false with guidance instead of a summary.

Run estimate_trip first so the summary reflects the weather-adjusted suggested pickup time.

Annotations

Section titled “Annotations”
Hint Value
readOnlyHint false
destructiveHint false

Prerequisites: All 6 required fields must be set: pickup_address, dropoff_address, appointment_time, trip_type, transport_mode (or service_type or service_type_id), treatment_type (or treatment_type_id). Roundtrips also require return_type.

Input

Section titled “Input”
Field Type Required
session_id string yes

Output

Section titled “Output”
Field Type Description
status string success or error
member_name string Member name
pickup_address string Formatted pickup address
dropoff_address string Formatted dropoff address
pickup_facility_name string Pickup facility name
dropoff_facility_name string Dropoff facility name
pickup_apt_suite string Pickup apt/suite
dropoff_apt_suite string Dropoff apt/suite
appointment_time string Display time
pickup_time string Display time
trip_type string Trip type
transport_mode string Display name
return_type string will_call or scheduled
return_time string Return time (if scheduled)
treatment_type string Appointment type
special_needs string Special accommodations
companion_name string Companion info
notes string Trip notes
adult_count int64 Adult passengers
pca_count int64 PCA count
attendant_count int64 Attendant count
child_count int64 Child count
ready_to_confirm bool Ready for confirm_trip
booking_status string PREVIEW_ONLY
missing_required string[] Missing required fields
recommendations string[] Optional fields to ask about
voice_script string TTS-ready script for AI to read aloud
booking_progress BookingProgress Step 3/4

Example Response

Section titled “Example Response”
{
  "status": "success",
  "member_name": "John Doe",
  "pickup_address": "123 Main St, Springfield, IL 62701",
  "dropoff_address": "456 Health Ave, Springfield, IL 62701",
  "dropoff_facility_name": "DaVita Dialysis Center",
  "appointment_time": "Tuesday, April 8, 2026 at 2:00 PM",
  "pickup_time": "1:15 PM",
  "trip_type": "Round Trip",
  "transport_mode": "Wheelchair Van",
  "return_type": "will_call",
  "treatment_type": "Dialysis",
  "companion_name": "None",
  "special_needs": "None",
  "adult_count": 1,
  "ready_to_confirm": true,
  "booking_status": "PREVIEW_ONLY — call confirm_trip to finalize",
  "voice_script": "Okay John Doe, let me read back your trip details. We'll pick you up at 1:15 PM from 123 Main St...",
  "booking_progress": {
    "current_step": 3, "total_steps": 4,
    "next_required": "confirm_trip"
  }
}

Error Codes

Section titled “Error Codes”
  • MISSING_PREREQUISITE – Required fields not set
Section titled “Related”