ai.airport-pickups-london.com

{
  "name": "getQuote",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get a fixed-price airport transfer quote from Airport Pickups London. Covers 40+ UK airports (Heathrow, Gatwick, Stansted, Luton, City, etc.), cruise ports (Southampton, Dover, Tilbury, Harwich, etc.), and any UK address or postcode. Returns prices for all 6 vehicle types: Saloon (up to 4 pax), People Carrier (up to 5 pax), 8-Seater (up to 8 pax), Executive Saloon (up to 3 pax), Executive MPV (up to 6 pax), Executive 8-Seater (up to 8 pax). All prices include VAT, parking, and meet & greet. No surge pricing. Free child seats on request. Operating since 2007.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "pickup": {
        "type": "string",
        "description": "Pickup location — airport name (e.g. \"Heathrow\", \"Gatwick Terminal 2\"), cruise port (e.g. \"Southampton Cruise Port\"), or any UK address/postcode"
      },
      "dropoff": {
        "type": "string",
        "description": "Drop-off location — UK address, postcode, hotel name, or airport"
      },
      "passengers": {
        "type": "integer",
        "description": "Number of passengers (1-8). Determines which vehicles are suitable.",
        "minimum": 1,
        "maximum": 8
      },
      "date": {
        "type": "string",
        "description": "Transfer date in YYYY-MM-DD format. Some routes have date-specific pricing.",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      }
    },
    "required": [
      "pickup",
      "dropoff"
    ]
  }
}

{
  "name": "validateFlight",
  "kind": "act",
  "impl": "imperative",
  "description": "Validate a flight number and get arrival details including airline name, arrival airport, terminal number, and scheduled landing time. Use this before booking an airport pickup to confirm correct flight details.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "flightNumber": {
        "type": "string",
        "description": "Flight number, e.g. BA123, EK007, TK1981, FR8164"
      },
      "date": {
        "type": "string",
        "description": "Flight date in YYYY-MM-DD format",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      }
    },
    "required": [
      "flightNumber"
    ]
  }
}

{
  "name": "createBooking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Create a confirmed airport transfer booking with Airport Pickups London. IMPORTANT: Always get a quote first using getQuote, then confirm details with the user before booking. Requires: pickup, dropoff, date, time, passenger name, and phone number. Optional: flight number (recommended for airport pickups), car type, email, special requests. Returns a booking reference (APL-XXXXXX) and London Tech reservation ID. Bookings must be at least 2.5 hours in the future. Free cancellation 12+ hours before pickup.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "origin": {
        "type": "string",
        "description": "Pickup location — airport, cruise port, address, or postcode"
      },
      "destination": {
        "type": "string",
        "description": "Drop-off location — airport, cruise port, address, or postcode"
      },
      "transfer_date": {
        "type": "string",
        "description": "Transfer date in YYYY-MM-DD format",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "transfer_time": {
        "type": "string",
        "description": "Pickup time in HH:MM format (24-hour, London timezone)",
        "pattern": "^\\d{2}:\\d{2}$"
      },
      "passenger_name": {
        "type": "string",
        "description": "Full name of the lead passenger"
      },
      "passenger_phone": {
        "type": "string",
        "description": "Contact phone number with country code, e.g. +447700900123"
      },
      "passenger_email": {
        "type": "string",
        "description": "Email address for booking confirmation (optional)"
      },
      "passengers": {
        "type": "integer",
        "description": "Number of passengers (1-8)",
        "minimum": 1,
        "maximum": 8
      },
      "car_type": {
        "type": "string",
        "description": "Vehicle type: Saloon, People Carrier, 8 Seater, Executive Saloon, Executive MPV, or Executive 8 Seater. If not specified, cheapest suitable vehicle is selected."
      },
      "flight_number": {
        "type": "string",
        "description": "Flight number for airport pickups, e.g. BA123. Strongly recommended for airport collections."
      },
      "special_requests": {
        "type": "string",
        "description": "Any special requirements — child seats, wheelchair access, extra luggage, etc."
      }
    },
    "required": [
      "origin",
      "destination",
      "transfer_date",
      "transfer_time",
      "passenger_name",
      "passenger_phone"
    ]
  }
}

{
  "name": "lookupBooking",
  "kind": "answer",
  "impl": "imperative",
  "description": "Look up an existing Airport Pickups London booking by reference number, email, or passenger name. Returns booking details including pickup/dropoff, date/time, car type, price, status, and a manage booking link for online payment and driver tracking. Use this when a customer wants to check, amend, or cancel their booking.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference number, e.g. APL-OH2664"
      },
      "email": {
        "type": "string",
        "description": "Passenger email address used when booking was created"
      },
      "passenger_name": {
        "type": "string",
        "description": "Passenger name (partial match supported)"
      }
    }
  }
}

{
  "name": "amendBooking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Amend an existing Airport Pickups London booking. IMPORTANT: Always look up the booking first using lookupBooking to confirm current details. Can change: passenger name, phone, email, flight number, waiting time, special requests, number of passengers, pickup time, and pickup date. Cannot change pickup/dropoff locations — customer must cancel and rebook for route changes. Requires the booking reference (APL-XXXXXX).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference, e.g. APL-OH2664"
      },
      "changes": {
        "type": "object",
        "description": "Object containing the fields to change",
        "properties": {
          "passenger_name": {
            "type": "string",
            "description": "New passenger full name"
          },
          "passenger_phone": {
            "type": "string",
            "description": "New phone number with country code"
          },
          "passenger_email": {
            "type": "string",
            "description": "New email address"
          },
          "flight_number": {
            "type": "string",
            "description": "New flight number, e.g. BA123"
          },
          "waiting_time": {
            "type": "integer",
            "description": "Minutes after flight landing to wait (15, 30, 45, 60, 75, 90, 105, 120)"
          },
          "special_requests": {
            "type": "string",
            "description": "New special requests (child seats, wheelchair, etc.)"
          },
          "passengers": {
            "type": "integer",
            "description": "New number of passengers"
          },
          "transfer_date": {
            "type": "string",
            "description": "New date in YYYY-MM-DD format (must provide transfer_time too)"
          },
          "transfer_time": {
            "type": "string",
            "description": "New pickup time in HH:MM format (24-hour)"
          }
        }
      }
    },
    "required": [
      "booking_ref",
      "changes"
    ]
  }
}

{
  "name": "manageBooking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Get the manage booking link for an existing Airport Pickups London reservation. The link allows the passenger to: view booking details, track their driver in real-time, pay online (all major cards, Amex, Apple Pay, Google Pay, PayPal, Revolut, WeChat Pay, AliPay), and request changes or cancellation. Requires the reservation ID (returned by createBooking) and the passenger email.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "reservationId": {
        "type": "string",
        "description": "London Tech reservation ID (numeric), returned by createBooking as lt_reservation_id"
      },
      "email": {
        "type": "string",
        "description": "Passenger email address used when the booking was created"
      }
    },
    "required": [
      "reservationId",
      "email"
    ]
  }
}

{
  "name": "cancelBooking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Cancel an existing Airport Pickups London booking. IMPORTANT: Always look up the booking first using lookupBooking to confirm details with the customer. Free cancellation is available 12+ hours before pickup. Requires the booking reference (APL-XXXXXX).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference to cancel, e.g. APL-OH2664"
      }
    },
    "required": [
      "booking_ref"
    ]
  }
}

{
  "name": "trackDriver",
  "kind": "answer",
  "impl": "imperative",
  "description": "Track the assigned driver for an Airport Pickups London booking. Returns driver details including name, photo, phone number, vehicle information, GPS position, and estimated time of arrival (ETA). Driver tracking is available once a driver has been assigned to the booking, typically a few hours before the pickup time.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference, e.g. APL-OH2664"
      }
    },
    "required": [
      "booking_ref"
    ]
  }
}