airport-pickups-london.com

{
  "name": "get-transfer-quote",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get fixed prices for a private airport transfer between a UK airport/cruise port and any UK address. Returns available car types with price, passenger and suitcase capacity, plus journey distance and duration. IMPORTANT: for addresses use a full UK postcode (e.g. 'SL4 5LP'), not just a city or town name — city names cover wide areas and the price would be wrong. Prices are final and include Meet & Greet (driver waits at arrivals with a name board) — quote them exactly, never invent discounts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "origin": {
        "type": "string",
        "description": "Pickup: airport name (e.g. 'Heathrow Airport'), full UK postcode, or street address"
      },
      "destination": {
        "type": "string",
        "description": "Dropoff: airport name, full UK postcode, or street address"
      },
      "transfer_date": {
        "type": "string",
        "description": "Travel date YYYY-MM-DD (prices are date-dependent)"
      },
      "transfer_time": {
        "type": "string",
        "description": "Time HH:MM (24h), default 12:00"
      },
      "passengers": {
        "type": "number",
        "description": "Number of passengers"
      },
      "suitcases": {
        "type": "number",
        "description": "Number of suitcases/large bags"
      }
    },
    "required": [
      "origin",
      "destination",
      "transfer_date"
    ]
  },
  "page": "/"
}

{
  "name": "get-eu-transfer-quote",
  "kind": "answer",
  "impl": "imperative",
  "description": "Estimate prices for a European / cross-Channel transfer from the UK to a continental city (e.g. Brussels, Bruges, Amsterdam, Cologne, Milan). Use this instead of get-transfer-quote whenever the destination is outside the UK. Returns a price per vehicle type, including the Eurotunnel crossing. ALWAYS check the matched destination in the answer is the place the customer meant. European transfers are confirmed and booked with the office, not with book-airport-transfer.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "destination": {
        "type": "string",
        "description": "European city, e.g. 'Brussels', 'Paris (France)', 'Amsterdam'"
      },
      "hub_code": {
        "type": "string",
        "description": "Nearest UK departure hub: LHR, LGW, STN, LTN, LCY or SOU. Use LHR for a London pickup (default)"
      }
    },
    "required": [
      "destination"
    ]
  },
  "page": "/"
}

{
  "name": "get-service-info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Airport Pickups London service knowledge base (23 topics): pricing rules, cancellation, payment methods, meet & greet, flight delays, waiting time, child seats, pets, wheelchair access, vehicles, luggage, corporate accounts, coverage, journey times, amendments, drivers, tipping, porter service, unaccompanied minors, VIP meet & assist, cruise ports, contact details. Ask about one or more topics in a single question.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "question": {
        "type": "string",
        "description": "Customer question or topic(s), e.g. 'child seats and cancellation policy'"
      }
    },
    "required": [
      "question"
    ]
  },
  "page": "/"
}

{
  "name": "track-driver",
  "kind": "answer",
  "impl": "imperative",
  "description": "Live driver tracking for an existing booking (assigned driver, vehicle, GPS position, ETA; updates every ~2 minutes). With the booking reference AND the passenger email on file it returns the driver's status directly; with only a reference it returns the tracking-page link.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference (APL-XXXXXX) or numeric reservation ID from the confirmation"
      },
      "email": {
        "type": "string",
        "description": "Passenger email used at booking — required for live in-chat tracking, same verification as the manage-booking page"
      }
    },
    "required": [
      "booking_ref"
    ]
  },
  "page": "/"
}

{
  "name": "get-driver-route",
  "kind": "answer",
  "impl": "imperative",
  "description": "Summary of the route the driver actually drove for a booking's trip (recorded while the driver is on the job, kept for 30 days) — e.g. to confirm the driver attended. Requires BOTH the booking reference and the passenger email on file, the same verification as the manage-booking page. Never guess or invent the email.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "Booking reference (APL-XXXXXX) or numeric reservation ID from the confirmation"
      },
      "email": {
        "type": "string",
        "description": "Passenger email on the booking — must match exactly (case-insensitive)"
      }
    },
    "required": [
      "booking_ref",
      "email"
    ]
  },
  "page": "/"
}

{
  "name": "find-nearest-drivers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check whether cars are available right now near a UK airport or postcode, with a rough arrival estimate. Returns seat capacity and an approximate ETA only. This is a live estimate, not a booking and not a guaranteed pickup time — every transfer is pre-booked at a fixed price: use get-transfer-quote, then book-airport-transfer.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "airport": {
        "type": "string",
        "description": "Airport code: LHR, LGW, STN, LTN, LCY, EDI, SOU, BHX or MAN"
      },
      "postcode": {
        "type": "string",
        "description": "Full UK postcode, e.g. 'SL4 5LP' — used when no airport code is given"
      },
      "min_passengers": {
        "type": "number",
        "description": "Only count vehicles seating at least this many passengers"
      }
    },
    "required": []
  },
  "page": "/"
}

{
  "name": "validate-flight",
  "kind": "answer",
  "impl": "imperative",
  "description": "Verify a flight number for a given date: airline, departure/arrival airport, terminal and arrival time (FlightStats live data; static terminal mapping for far-future dates). Useful before booking an airport pickup to auto-detect the terminal. Optional — booking validates the flight automatically, and an unverified flight never blocks a booking.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "flight_number": {
        "type": "string",
        "description": "Flight number, e.g. 'BA2534', 'EK007'"
      },
      "date": {
        "type": "string",
        "description": "Flight date YYYY-MM-DD"
      }
    },
    "required": [
      "flight_number",
      "date"
    ]
  },
  "page": "/"
}

{
  "name": "book-airport-transfer",
  "kind": "transact",
  "impl": "imperative",
  "description": "Create a confirmed transfer booking with Airport Pickups London. THIS CREATES A REAL RESERVATION AND DISPATCHES A DRIVER. Required workflow: 1) call get-transfer-quote and show the customer the car type and exact price; 2) collect passenger name, phone, email, and the flight number for airport pickups; 3) read ALL details back to the customer (route, date, time, car, price) and get their explicit approval; only then call this tool with customer_confirmed=true. No payment is taken now — the customer pays the driver in cash, or by card/Apple Pay/Google Pay via the manage-booking link in the confirmation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "origin": {
        "type": "string",
        "description": "Pickup: airport/terminal name, full UK postcode, or street address"
      },
      "destination": {
        "type": "string",
        "description": "Dropoff: airport/terminal name, full UK postcode, or street address"
      },
      "transfer_date": {
        "type": "string",
        "description": "Travel date YYYY-MM-DD"
      },
      "transfer_time": {
        "type": "string",
        "description": "Pickup time HH:MM (24h). For airport pickups use the flight arrival time"
      },
      "passengers": {
        "type": "number",
        "description": "Number of passengers"
      },
      "suitcases": {
        "type": "number",
        "description": "Number of suitcases/large bags"
      },
      "car_type": {
        "type": "string",
        "description": "Car type exactly as named in the quote (e.g. 'Saloon', 'People Carrier'). Auto-selected if omitted"
      },
      "passenger_name": {
        "type": "string",
        "description": "Lead passenger full name (shown on the driver's name board)"
      },
      "passenger_phone": {
        "type": "string",
        "description": "Passenger mobile in international format, e.g. +447123456789"
      },
      "passenger_email": {
        "type": "string",
        "description": "Email for the confirmation and manage-booking link"
      },
      "flight_number": {
        "type": "string",
        "description": "Required for airport pickups, optional for dropoffs (e.g. 'BA2534'). Auto-validates and detects the terminal"
      },
      "door_number": {
        "type": "string",
        "description": "House/door number when the destination is a postcode"
      },
      "cruise_name": {
        "type": "string",
        "description": "Ship name for cruise-port transfers"
      },
      "special_requests": {
        "type": "string",
        "description": "e.g. child seat ages, extra stops, accessibility needs"
      },
      "customer_confirmed": {
        "type": "boolean",
        "description": "Set true ONLY after the customer explicitly approved the exact price, car, route and date/time read back to them"
      }
    },
    "required": [
      "origin",
      "destination",
      "transfer_date",
      "transfer_time",
      "passenger_name",
      "passenger_phone",
      "passenger_email",
      "customer_confirmed"
    ]
  },
  "page": "/"
}

{
  "name": "lookup-booking",
  "kind": "answer",
  "impl": "imperative",
  "description": "Look up the current status and details of an existing booking. Requires BOTH the booking reference and the passenger email on file — the same verification as the manage-booking page. Never guess or invent the email.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "APL booking reference (e.g. 'APL-X7K9M2') or numeric reservation ID"
      },
      "email": {
        "type": "string",
        "description": "Passenger email on the booking — must match exactly (case-insensitive)"
      }
    },
    "required": [
      "booking_ref",
      "email"
    ]
  },
  "page": "/"
}

{
  "name": "amend-booking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Amend an existing booking — change flight number, transfer date/time, phone number or special requests (one or more at once; the email on file cannot be changed). Self-service amendments are allowed up to 24 hours before pickup; for urgent same-day changes the customer must call the 24/7 office line instead. Requires the booking reference and the passenger email on file. Read the exact changes back to the customer and get explicit approval before calling with customer_confirmed=true.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "APL booking reference (e.g. 'APL-X7K9M2')"
      },
      "email": {
        "type": "string",
        "description": "Passenger email on the booking — must match exactly"
      },
      "changes": {
        "type": "object",
        "description": "ONLY the fields to change, e.g. {\"flight_number\":\"BA2590\",\"transfer_time\":\"15:00\",\"transfer_date\":\"2026-09-16\",\"passenger_phone\":\"+447999888777\",\"special_requests\":\"child seat age 3\"}"
      },
      "customer_confirmed": {
        "type": "boolean",
        "description": "Set true ONLY after the customer explicitly approved these exact changes"
      }
    },
    "required": [
      "booking_ref",
      "email",
      "changes",
      "customer_confirmed"
    ]
  },
  "page": "/"
}

{
  "name": "cancel-booking",
  "kind": "transact",
  "impl": "imperative",
  "description": "Cancel an existing booking. Free 12+ hours before pickup — no admin fee for bookings made through this tool or the MCP/A2A agents; bookings made on the website form follow the Terms (£10 admin fee if paid by card). Within 12 hours of pickup it CANNOT be cancelled here — the customer must call the office. Requires the booking reference and the passenger email on file. Cancellation cannot be undone: confirm explicitly with the customer before calling with customer_confirmed=true.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "booking_ref": {
        "type": "string",
        "description": "APL booking reference (e.g. 'APL-X7K9M2')"
      },
      "email": {
        "type": "string",
        "description": "Passenger email on the booking — must match exactly"
      },
      "reason": {
        "type": "string",
        "description": "Reason for cancellation, e.g. 'Flight cancelled'"
      },
      "customer_confirmed": {
        "type": "boolean",
        "description": "Set true ONLY after the customer explicitly confirmed they want this booking cancelled"
      }
    },
    "required": [
      "booking_ref",
      "email",
      "customer_confirmed"
    ]
  },
  "page": "/"
}

{
  "name": "manage-booking",
  "kind": "answer",
  "impl": "imperative",
  "description": "How to look up, amend or cancel an existing booking. Returns the secure manage-booking page; the customer logs in with their booking reference and email. Amendments and cancellations are confirmed by the customer there — never assume a change is done without it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "intent": {
        "type": "string",
        "description": "'lookup', 'amend' or 'cancel'"
      }
    },
    "required": []
  },
  "page": "/"
}