Sky High Party Rentals

Look up a Sky High rental product by name. Returns the page URL, units in stock, how many times families have booked it, and price. ALWAYS pass event_date (and zip when you know it) - with a date this returns the EXACT price for that date and whether it is available, which you should quote directly. Prices returned here are LIVE - prefer them over any knowledge-file price, and never send the customer to the product page to find a price this tool can give you.

{
  "type": "object",
  "properties": {
    "product_name": {
      "type": "string",
      "description": "Product name or close description, e.g. 'Niagara water slide'"
    },
    "event_date": {
      "type": "string",
      "description": "Event date YYYY-MM-DD. Always pass it when the customer has said their date - it returns the exact price for that day."
    },
    "zip": {
      "type": "string",
      "description": "5-digit delivery zip, when known. Selects the right metro's pricing."
    }
  },
  "required": [
    "product_name"
  ]
}

Build a complete, real quote for one rental on a specific date and delivery zip: exact dated item price, availability, delivery fee, that date's minimum order, the total, and the booking link. Use this the moment you know the product, the date and the zip - it is the fastest way to answer 'how much?' properly. If you are missing the date or zip, ask the customer for it (never guess a zip from their IP or city) and then call this.

{
  "type": "object",
  "properties": {
    "product_name": {
      "type": "string",
      "description": "Product name or close description"
    },
    "event_date": {
      "type": "string",
      "description": "Event date YYYY-MM-DD"
    },
    "zip": {
      "type": "string",
      "description": "5-digit delivery zip the customer gave you"
    },
    "start_time": {
      "type": "string",
      "description": "When the party starts, in their words (\"10am\", \"2:30pm\"). For a rental with an attendant (mechanical bull etc.), when it should start running. Pass start_time AND end_time whenever they have said them: the price depends on party length."
    },
    "end_time": {
      "type": "string",
      "description": "When the party ends, in their words (\"1pm\"). For an attended rental, when it should stop running - not the pickup time."
    },
    "quantity": {
      "type": "number",
      "description": "How many of this item, default 1"
    },
    "coupon": {
      "type": "string",
      "description": "Optional: CHAT10 once you have offered it, or a code the customer typed. Returns with_coupon, the exact discounted total, so you never do discount math yourself."
    },
    "items": {
      "type": "array",
      "description": "Two or more items for the SAME party: pass them all here (product_name = the first one) to get ONE order total with one delivery fee. Never add up separate quotes.",
      "items": {
        "type": "object",
        "properties": {
          "product_name": {
            "type": "string"
          },
          "qty": {
            "type": "number"
          }
        },
        "required": [
          "product_name"
        ]
      }
    }
  },
  "required": [
    "product_name",
    "event_date",
    "zip"
  ]
}

Look up the delivery fee and minimum order for a Texas delivery zip code. Use when a customer asks what delivery costs or what the minimum order is for their area. ALWAYS pass event_date when the customer has mentioned their party date - minimum orders vary by date and the dated answer is exact. Without a date the answer is the general rule.

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "description": "5-digit delivery zip code"
    },
    "event_date": {
      "type": "string",
      "description": "Event date YYYY-MM-DD, when the customer has mentioned it. Always include if known."
    }
  },
  "required": [
    "zip"
  ]
}

Add one rental to a real Sky High cart for a party date, delivery ZIP and hours, and get back a cart_id. Call build_quote first if the customer has not seen the price. To add more items to the SAME party, call again with the cart_id from the first call (one cart, one delivery fee). Safe to repeat: an item already in the cart is not added twice. Added is NOT reserved: nothing is held until the customer pays at checkout. Next step: prepare_checkout with the cart_id.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "The product_id from build_quote or product_info. Preferred: it books exactly that product."
    },
    "product": {
      "type": "string",
      "description": "Product name, e.g. 'Turtle Beach water slide', when there is no product_id."
    },
    "date": {
      "type": "string",
      "description": "Party date, YYYY-MM-DD"
    },
    "zip": {
      "type": "string",
      "description": "5-digit delivery ZIP (selects Houston, Austin or Dallas)"
    },
    "quantity": {
      "type": "number",
      "description": "How many, default 1. A package whose name already lists its counts is quantity 1."
    },
    "start_time": {
      "type": "string",
      "description": "Party start, e.g. 14:00 or 2pm (default 12:00)"
    },
    "end_time": {
      "type": "string",
      "description": "Party end, e.g. 18:00 or 6pm (default 4 hours after the start). The price depends on the length."
    },
    "overnight": {
      "type": "boolean",
      "description": "true = keep it overnight, picked up after 8 AM the next morning"
    },
    "operating_mode": {
      "type": "string",
      "enum": [
        "wet",
        "dry"
      ],
      "description": "For a slide or combo that can run wet or dry: how the customer wants it. Ask them. Some units charge for wet use (a misting hose); the tool reports the charge."
    },
    "cart_id": {
      "type": "string",
      "description": "The cart_id from an earlier add_to_cart, to add to the same cart. Leave out to start a new cart."
    }
  },
  "required": [
    "date",
    "zip"
  ]
}

Get a cart ready for checkout. Re-checks that everything is still available for the date and that the cart meets that date's minimum, then returns the items, the price breakdown (delivery, fees, tax, total, deposit due today), what the customer still has to enter, and handoff_url: a private link that opens this exact cart at checkout on any phone or computer. This tool never pays or places the order: the customer pays on that page, or, once they have authorized it, you complete checkout there for them. Give handoff_url to the customer only.

{
  "type": "object",
  "properties": {
    "cart_id": {
      "type": "string",
      "description": "The cart_id from add_to_cart"
    }
  },
  "required": [
    "cart_id"
  ]
}