Query the availability endpoint with origin (airport IATA code or coordinates), destination (hotel address or coordinates), passenger count, and outbound datetime; include return journey details if round-trip.
Parse the list of vehicle options returned, each with a vehicle type, capacity, price, and meetAndGreet boolean indicating whether the driver will hold a name board.
Confirm the selected transfer by POSTing the vehicle option ID, passenger count, flight number (used for flight tracking so the driver waits on delays), and lead passenger contact details.
Capture the booking reference and supplier voucher code; deliver the voucher to the traveler as the driver will verify it at pickup.
For airport pickups, retrieve the meeting point instructions from the response — these are terminal/arrival-hall specific and critical for the passenger.
Implement a webhook or polling mechanism for driver-assigned and driver-on-the-way status events so passengers receive real-time updates.
Known gotchas
Flight number is used for live flight tracking to adjust pickup time automatically; if omitted or incorrect, the driver may not wait for a delayed flight.
Child seat requirements must be specified at booking time — suppliers cannot always accommodate last-minute requests and may refuse the journey.
Prices for private transfers are per vehicle, not per person; group size validation against vehicle capacity must be enforced client-side before booking.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp