Tool reference - Widgety Docs

You never call these yourself. The assistant picks the right tool from your question. This list is here so you know what’s possible.

Find sailings

Tool	What it does
`search_cruises`	Searches live inventory from a brief. Returns up to 35 matches, best first.
`get_best_value_sailings`	Ranks sailings by price per night.
`find_solo_deals`	Ranks sailings by single-occupancy supplement.
`get_fly_cruise_options`	Fly-cruises from UK and Ireland airports.
`get_no_results_alternatives`	Suggests alternatives when a search comes back empty.

See what you can sell

Tool	What it does
`get_allowed_cruise_lines`	The cruise lines your key can sell.
`get_inventory_facets`	Regions, ports, lines and ships available to you.
`get_consolidated_metadata`	Matches shorthand (“RCI”, “QM2”) to the right line, ship or port.
`get_cruise_search_capabilities`	The full search schema and workflows, for developers.

Understand a sailing

Tool	What it does
`get_cruise_details`	Full detail for one sailing.
`get_cruise_itinerary`	Day-by-day ports and times.
`get_cruise_accommodations`	Cabin grades on that sailing.
`get_ship_details`	Ship facts, dining and facilities.
`get_cruise_images`	Ship, port and cruise line images for proposals.
`get_brochures_attachments`	Brochures, deck plans and PDFs.
`get_port_logistics_profile`	Transfers, tenders, overnights and how busy each port is.

Price and margin

Tool	What it does
`get_cabin_and_fare_options`	Grades, availability, single, third and fourth passenger and flight fares.
`get_commission_breakdown`	Commissionable base per cabin grade.
`get_price_trends`	How prices have moved for a route or line.
`get_port_statistics`	Operator, route and port statistics.

Compare and propose

Tool	What it does
`compare_sailings`	Puts 2–4 sailings side by side, with route maps.
`get_widgety_brand_kit`	Widgety branding for proposals.
`extract_brand_kit`	Picks up your agency’s colours, fonts and logo from its website.
`generate_design_kit`	Turns a brand kit into settings for client-ready documents.

Remember clients

Tool	What it does
`remember_traveller`	Saves a client’s preferences and shortlist, when you ask.
`recall_travellers`	Brings a saved client back and flags price or availability changes.
`check_quote_freshness`	Checks whether earlier quotes still stand.
`forget_traveller`	Permanently deletes a saved client.