Server definition
- Hash
- sha256:e2d7b88524f357cb19615da13b678e762ae484f811eff91d6e36330327afdb1e
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Shows cheapest one-way flight prices across a date range. Returns daily prices with price band thresholds for comparison. Use with origin/destination IATA codes from places_find_location. Defaults to next 6 months if no dates provided.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currencyCode": {
"description": "The currency the user pays in, as an ISO 4217 code (e.g. 'SAR', 'INR', 'USD'): the one they ask for, else the currency of their own country (siteCode). Do NOT take it from the destination: a user in India booking Dubai pays in 'INR'. Send the same code on every flight and hotel call in this conversation, searchId reads included.",
"type": "string"
},
"destination": {
"description": "Arrival city IATA code (e.g., BKK, PAR, TYO)",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"directOnly": {
"default": false,
"description": "Show direct flights only",
"type": "boolean"
},
"endDate": {
"$ref": "#/properties/startDate",
"description": "End date (YYYY-MM-DD). Defaults to 6 months from start."
},
"locale": {
"description": "Locale for results (e.g., 'en', 'ar', 'zh'). If not provided, uses the locale from the user's settings. Supports BCP 47 format (e.g., 'ar-SA' resolves to 'ar').",
"type": "string"
},
"origin": {
"description": "Departure city IATA code (e.g., LON, NYC, SIN)",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"startDate": {
"description": "Start date (YYYY-MM-DD). Defaults to today.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"origin",
"destination",
"currencyCode"
],
"type": "object"
},
"name": "flights_one_way_price",
"outputSchema": null
},
{
"description": "Gets the current published timetable of nonstop flights between two cities: airlines, flight numbers, departure and arrival airports and times, duration, and operating periods (dates, weekdays and aircraft). Connecting flights are not listed: use flights_search for those and for fares on a date. Accepts city or airport IATA codes from places_find_location; an airport code gives its city's timetable. Results are paged: when metadata.hasMore is true, call again with page + 1. Optionally filter by airline code.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"airline": {
"description": "Optional: Filter by airline code (2-letter IATA code, e.g., 'EK', 'SQ')",
"pattern": "^[A-Z0-9]{2}$",
"type": "string"
},
"from": {
"description": "Departure city or airport code (IATA, e.g., 'SIN' or 'LHR'). An airport code gives its city's timetable.",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"locale": {
"description": "Locale for results (e.g., 'en', 'ar', 'zh'). If not provided, uses the locale from the user's settings. Supports BCP 47 format (e.g., 'ar-SA' resolves to 'ar').",
"type": "string"
},
"page": {
"description": "Page of flights, 1-based (default 1). Rarely needed: most routes fit on one page.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"pageSize": {
"description": "Flights per page (default and max 200). Use it to narrow a long answer.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "Arrival city or airport code (IATA, e.g., 'BKK' or 'LHR'). An airport code gives its city's timetable.",
"pattern": "^[A-Z]{3}$",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "flights_schedule",
"outputSchema": null
},
{
"description": "Searches for flights between airports or cities. Not for flight status, price tracking, visa information, bookings, or reservation management.\n\nPolling flow:\n1. First call with newSearch → creates search session, returns searchId immediately (status: \"created\", pollAgainInSeconds: 5).\n2. Wait pollAgainInSeconds, then call again with searchId → returns flight results with status \"incomplete\" (cheaper fares still arriving, pollAgainInSeconds says when to call again) or \"complete\" (final results).\n3. While status is \"incomplete\", wait pollAgainInSeconds and call again. Stop when status is \"complete\". If it is still \"incomplete\" after 3 reads, use the results you have.\n\nA search is complete about 30 seconds after it is created. After that, every read (another page, new filters or sorting) returns status \"complete\" at once.\n\nParameters:\n- newSearch: Route (from/to as IATA codes), dates (fromDate, toDate in YYYY-MM-DD), passengers, and cabin class. Omit toDate for one-way trips.\n- Defaults when not specified: 1 adult, 0 children, 0 infants, economy cabin.\n- filters: Include only when the user mentions specific preferences (airlines, stops, times, price range, etc.).\n- sorting: A single string value. Options: score_desc (recommended, default), price_asc (cheapest), duration_asc (fastest), leg1_departure_time_asc/desc (outbound departure), leg2_departure_time_asc/desc (return departure, round-trip only).\n- page, pageSize: Which page of the ranked trips a searchId read returns. page 1-100 (default 1), pageSize 1-50 (default 20). Out-of-range values are rejected.\n\nPaging: every searchId read returns metadata {page, pageSize, resultCount, totalCandidates, hasMore}. totalCandidates counts trips matching the filters across all pages; resultCount counts this page. For more trips, repeat the searchId with the same filters and sorting and page + 1 while hasMore is true. Featured trips appear on page 1 only, and labels (best_value, cheapest, cheapest_direct) are judged over all matching trips, not the page.\n\nFilter options: a page-1 read with searchId returns filterOptions with the airlines, alliances, bookingSites and stopoverAirports found in this search; page 2 and later do not. While status is \"incomplete\" the lists are partial and can grow; when status is \"complete\" they are final. Each entry is { code, name, price }, where price is the cheapest per-person price in the search currency, before filters. Every code is a valid value for the filter of the same name. Use these codes in filters on the next read instead of guessing.\n\nTime filtering (two approaches, mutually exclusive per dimension):\n1. Time blocks (6-hour windows) — for broad preferences:\n - Options: \"midnight\" (12am-6am), \"morning\" (6am-12pm), \"afternoon\" (12pm-6pm), \"night\" (6pm-12am)\n - Example: outboundDepartureTimeBlocks: [\"morning\", \"afternoon\"] = depart before 6pm\n\n2. Time ranges (minute precision) — for specific time requests:\n - Format: {min: minutesFromMidnight, max: minutesFromMidnight}, range 0-1440\n - Example: \"flights after 10pm\" → outboundDepartureTimeRange: {min: 1320, max: 1440}\n - Example: \"depart 8am-1pm\" → outboundDepartureTimeRange: {min: 480, max: 780}\n - Supports wraparound: {min: 1380, max: 60} = 11pm-1am (crosses midnight)\n\nTime blocks and time ranges cannot both be specified for the same dimension (e.g., outboundDeparture).\n\nRefinement: Provide the searchId from a previous response with updated filters or sorting. Refinement replaces all previous filters and sorting entirely — include existing values alongside new ones to preserve them.\n\nExample — changing return to after 10pm while keeping existing airlines [\"SQ\", \"KE\"], outbound 6am-8am, and price_asc sorting:\n{ \"searchId\": \"abc\", \"filters\": { \"airlines\": [\"SQ\", \"KE\"], \"outboundDepartureTimeRange\": { \"min\": 360, \"max\": 480 }, \"inboundArrivalTimeRange\": { \"min\": 1320, \"max\": 1440 } }, \"sorting\": \"price_asc\" }\n\nDefault behavior:\n- One date provided → one-way trip\n- Return date mentioned → round-trip\n- No preferences stated → omit filters\n- Specific time requested (e.g., \"after 10pm\") → use time range\n- Broad time preference (e.g., \"morning flights\") → use time blocks",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currencyCode": {
"description": "The currency the user pays in, as an ISO 4217 code (e.g. 'SAR', 'INR', 'USD'): the one they ask for, else the currency of their own country (siteCode). Do NOT take it from the destination: a user in India booking Dubai pays in 'INR'. Send the same code on every flight and hotel call in this conversation, searchId reads included.",
"type": "string"
},
"filters": {
"additionalProperties": false,
"description": "Flight filters to apply. When used with searchId (refinement), filters completely replace the previous filters. To preserve existing filters like airlines or departure times, include them again along with any new filters.",
"properties": {
"airlines": {
"description": "2-letter IATA airline codes. e.g. ['SQ', 'UA', 'LH']",
"items": {
"description": "2-letter IATA airline code",
"maxLength": 2,
"type": "string"
},
"type": "array"
},
"alliances": {
"description": "Airline alliances. e.g. ['star_alliance', 'oneworld', 'skyteam']",
"items": {
"enum": [
"star_alliance",
"oneworld",
"skyteam"
],
"type": "string"
},
"type": "array"
},
"bookingSites": {
"description": "Filter by specific travel booking sites. e.g. ['booking.com']",
"items": {
"description": "Travel booking site",
"type": "string"
},
"type": "array"
},
"bookingTypes": {
"description": "Booking channel - Book on Wego or direct with airline. e.g. ['wego', 'airline']",
"items": {
"enum": [
"wego",
"airline"
],
"type": "string"
},
"type": "array"
},
"destinationAirports": {
"description": "Filter by specific arrival airports. e.g. ['CDG']",
"items": {
"description": "Arrival IATA airport code",
"type": "string"
},
"type": "array"
},
"flightExperiences": {
"description": "Flight experience preferences. e.g. ['no_overnight_flight', 'no_long_stopover']",
"items": {
"enum": [
"no_overnight_flight",
"no_long_stopover"
],
"type": "string"
},
"type": "array"
},
"inboundArrivalTimeBlocks": {
"description": "Filter return flight arrival times for ROUND-TRIP searches. Use this to specify when you want the return leg to arrive back. e.g. ['morning', 'afternoon'] for arrivals before 6pm",
"items": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeBlocks/items"
},
"type": "array"
},
"inboundArrivalTimeRange": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeRange",
"description": "Granular return arrival time range in minutes from midnight for ROUND-TRIP searches. Cannot be used with inboundArrivalTimeBlocks."
},
"inboundDepartureTimeBlocks": {
"description": "Filter return flight departure times for ROUND-TRIP searches. Use this to specify when you want the return leg to depart. e.g. ['morning', 'afternoon'] for departures before 6pm",
"items": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeBlocks/items"
},
"type": "array"
},
"inboundDepartureTimeRange": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeRange",
"description": "Granular return departure time range in minutes from midnight for ROUND-TRIP searches. Cannot be used with inboundDepartureTimeBlocks."
},
"inboundTotalDurationRange": {
"additionalProperties": false,
"description": "Return flight duration filter (e.g., 'under 5 hours' = {max: 300}). Minutes. Round-trip only.",
"properties": {
"max": {
"description": "Maximum duration in minutes",
"type": "number"
},
"min": {
"description": "Minimum duration in minutes",
"type": "number"
}
},
"type": "object"
},
"originAirports": {
"description": "Filter by specific departure airports. e.g. ['JFK']",
"items": {
"description": "Departure IATA airport code",
"type": "string"
},
"type": "array"
},
"outboundArrivalTimeBlocks": {
"description": "Filter outbound arrival times. Use this to specify when you want to arrive at your destination. e.g. ['morning', 'afternoon'] for arrivals before 6pm",
"items": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeBlocks/items"
},
"type": "array"
},
"outboundArrivalTimeRange": {
"$ref": "#/properties/filters/properties/outboundDepartureTimeRange",
"description": "Granular outbound arrival time range in minutes from midnight. Use this for precise time filtering. Cannot be used with outboundArrivalTimeBlocks."
},
"outboundDepartureTimeBlocks": {
"description": "Filter outbound departure times. Use this to specify when you want to depart on the outgoing flight. e.g. ['morning', 'afternoon'] for departures before 6pm",
"items": {
"enum": [
"midnight",
"morning",
"afternoon",
"night"
],
"type": "string"
},
"type": "array"
},
"outboundDepartureTimeRange": {
"additionalProperties": false,
"description": "Granular outbound departure time range in minutes from midnight. Use this for precise time filtering (e.g., {min: 480, max: 780} for 8:00 AM - 1:00 PM). Cannot be used with outboundDepartureTimeBlocks.",
"properties": {
"max": {
"description": "End time in minutes from midnight (0-1440). Example: 780 = 1:00 PM. Supports max=1440 for end-of-day (midnight). For midnight wraparound (e.g., 11pm-1am), max can be less than min.",
"maximum": 1440,
"minimum": 0,
"type": "integer"
},
"min": {
"description": "Start time in minutes from midnight (0-1439). Example: 480 = 8:00 AM",
"maximum": 1439,
"minimum": 0,
"type": "integer"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"outboundTotalDurationRange": {
"additionalProperties": false,
"description": "Outbound flight duration filter (e.g., 'under 3 hours' = {max: 180}). Minutes.",
"properties": {
"max": {
"description": "Maximum duration in minutes",
"type": "number"
},
"min": {
"description": "Minimum duration in minutes",
"type": "number"
}
},
"type": "object"
},
"priceRange": {
"additionalProperties": false,
"description": "Budget filter (e.g., 'under $500' = {max: 500}). Per-person price in user's currency.",
"properties": {
"max": {
"description": "Maximum price per person",
"type": "number"
},
"min": {
"description": "Minimum price per person",
"type": "number"
}
},
"type": "object"
},
"stopoverAirports": {
"description": "Include flights with layovers at these airports. e.g. ['DXB']",
"items": {
"description": "Stopover/Transit IATA airport code",
"type": "string"
},
"type": "array"
},
"stops": {
"description": "Number of stops. e.g. Direct flight = 0, 1 stop = [1], direct or 1 stop = [0, 1]",
"items": {
"description": "Number of stops",
"type": "number"
},
"type": "array"
}
},
"type": "object"
},
"locale": {
"description": "Locale for results (e.g., 'en', 'ar', 'zh'). If not provided, uses the locale from the user's settings. Supports BCP 47 format (e.g., 'ar-SA' resolves to 'ar').",
"type": "string"
},
"newSearch": {
"additionalProperties": false,
"description": "Parameters required to create a new flight search when searchId is not provided. Include route (from/to), travel dates (fromDate/toDate in YYYY-MM-DD), and passenger counts. Use this to start a new Wego metasearch; omit when refining/polling an existing search via searchId.",
"properties": {
"adultsCount": {
"default": 1,
"description": "Number of adult passengers (18+). Default: 1. Example: 'my wife and I' = 2 adults",
"maximum": 9,
"minimum": 1,
"type": "number"
},
"cabinClass": {
"default": "economy",
"description": "Requested cabin class for the search",
"enum": [
"economy",
"premium_economy",
"business",
"first"
],
"type": "string"
},
"childrenCount": {
"default": 0,
"description": "Number of child passengers (2-17). Default: 0. Example: 'with my 5-year-old' = 1 child",
"maximum": 8,
"minimum": 0,
"type": "number"
},
"from": {
"description": "Departure IATA code (required for a new search when searchId is omitted).",
"minLength": 1,
"type": "string"
},
"fromDate": {
"description": "Departure date in YYYY-MM-DD (required for a new search when searchId is omitted).",
"minLength": 1,
"type": "string"
},
"infantsCount": {
"default": 0,
"description": "Number of infant passengers (under 2 years). Default: 0. Typically on parent's lap",
"maximum": 8,
"minimum": 0,
"type": "number"
},
"to": {
"description": "Arrival IATA code (required for a new search when searchId is omitted).",
"minLength": 1,
"type": "string"
},
"toDate": {
"description": "Return date in YYYY-MM-DD for round-trip searches. Omit entirely for one-way trips (do not send null or empty string).",
"type": "string"
}
},
"required": [
"from",
"to",
"fromDate"
],
"type": "object"
},
"page": {
"default": 1,
"description": "Page of trips a searchId read returns, 1-based (default 1, max 100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"pageSize": {
"default": 20,
"description": "Trips per page on a searchId read (default 20, max 50). Out-of-range or non-integer values are rejected, never clamped.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"searchId": {
"description": "Reuse the searchId from a previous search when refining, filtering, sorting, or selecting.",
"type": "string"
},
"siteCode": {
"description": "The user's OWN country as an ISO 3166-1 alpha-2 code (e.g. 'SG', 'SA', 'IN'), when the conversation shows where the user is. It picks the Wego site that booking links open and the market prices come from. Do NOT take it from the departure, arrival or hotel city: a user in India searching London is still 'IN'. Omit it when unknown (default 'US'). Set it when the search is created; a searchId read keeps the search's site.",
"pattern": "^(?:[A-Z]{2})?$",
"type": "string"
},
"sorting": {
"default": "score_desc",
"description": "Sort order for results. Pass a single string value. Options: score_desc (recommended, default), price_asc (cheapest), duration_asc (fastest), leg1_departure_time_asc/desc (outbound departure), leg2_departure_time_asc/desc (return departure, round-trip only).",
"enum": [
"score_desc",
"price_asc",
"duration_asc",
"leg1_departure_time_asc",
"leg1_departure_time_desc",
"leg2_departure_time_asc",
"leg2_departure_time_desc"
],
"type": "string"
}
},
"required": [
"currencyCode"
],
"type": "object"
},
"name": "flights_search",
"outputSchema": null
},
{
"description": "Discovers cheapest flight destinations from an origin city when the user has no specific destination in mind. Use for open-ended queries like 'where should I go?', 'cheapest flights from Dubai', 'surprise me', or 'best deals from Singapore'. Returns up to 15 cheapest destinations with prices, airlines, and travel dates. Do NOT use when user has a specific destination — use flights_search instead. Use IATA city codes from places_find_location.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currencyCode": {
"description": "The currency the user pays in, as an ISO 4217 code (e.g. 'SAR', 'INR', 'USD'): the one they ask for, else the currency of their own country (siteCode). Do NOT take it from the destination: a user in India booking Dubai pays in 'INR'. Send the same code on every flight and hotel call in this conversation, searchId reads included.",
"type": "string"
},
"departureDate": {
"description": "Departure date (YYYY-MM-DD). Optional; API picks best dates if omitted.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"locale": {
"description": "Locale for results (e.g., 'en', 'ar', 'zh'). If not provided, uses the locale from the user's settings. Supports BCP 47 format (e.g., 'ar-SA' resolves to 'ar').",
"type": "string"
},
"origin": {
"description": "Departure city IATA code (e.g., DXB, SIN, LON)",
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"returnDate": {
"$ref": "#/properties/departureDate",
"description": "Return date (YYYY-MM-DD). Optional; ignored for oneway trips."
},
"tripType": {
"default": "roundtrip",
"description": "Trip type: 'roundtrip' (default) or 'oneway'",
"enum": [
"roundtrip",
"oneway"
],
"type": "string"
}
},
"required": [
"origin",
"currencyCode"
],
"type": "object"
},
"name": "flights_search_anywhere",
"outputSchema": null
},
{
"description": "Looks up public holidays for a country within a date range. Used for travel planning to find local holidays at the destination.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country_code": {
"description": "ISO 3166-1 alpha-2 country code (e.g., 'SG', 'JP', 'US', 'TH')",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"end_date": {
"description": "End date for the holiday search range in YYYY-MM-DD format. The range covers at most 366 days.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"locale": {
"description": "Locale for localized holiday names (e.g., 'en', 'ar'). Defaults to 'en'.",
"type": "string"
},
"start_date": {
"description": "Start date for the holiday search range in YYYY-MM-DD format",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"country_code",
"start_date",
"end_date"
],
"type": "object"
},
"name": "holidays_lookup",
"outputSchema": null
},
{
"description": "Gets photos for one or more hotels (up to 8), up to 3 per category: rooms, bathrooms, dining, amenities such as the pool and gym, public spaces such as the lobby, exterior, views and nearby attractions. Hotels with no categories get up to 12 photos with no category. Use this tool for room photos too, because hotels_get_rooms gives only one image per room type. Use categoryFocus to show some categories first. missingHotelIds lists the hotels that could not be loaded.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"categoryFocus": {
"description": "Photo categories to show first (does not filter). Pool and gym photos are in Amenities, lobby photos are in Public Spaces. Categories: Rooms, Bathrooms, Dining, Amenities, Public Spaces, Exterior, Views, Nearby Attractions, Others.",
"items": {
"enum": [
"Rooms",
"Bathrooms",
"Dining",
"Amenities",
"Public Spaces",
"Exterior",
"Views",
"Nearby Attractions",
"Others"
],
"type": "string"
},
"type": "array"
},
"hotelIds": {
"description": "Array of hotel IDs to fetch photos for (1-8 hotels)",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Locale for the hotel name (e.g., 'en', 'ar'). Category names and photo descriptions are always English.",
"type": "string"
}
},
"required": [
"hotelIds"
],
"type": "object"
},
"name": "hotels_get_photos",
"outputSchema": null
},
{
"description": "Gets room rates for a specific hotel. Returns room types with pricing from multiple providers. Each rate's perNight price covers all rooms in the search together, for one night. Requires hotelId and searchId from a prior hotels_search call. If status is \"incomplete\", more rates are still loading: wait pollAgainInSeconds and call once more with the same arguments.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currencyCode": {
"description": "The currency the user pays in, as an ISO 4217 code (e.g. 'SAR', 'INR', 'USD'): the one they ask for, else the currency of their own country (siteCode). Do NOT take it from the destination: a user in India booking Dubai pays in 'INR'. Send the same code on every flight and hotel call in this conversation, searchId reads included.",
"type": "string"
},
"hotelId": {
"description": "Hotel ID from a previous hotels_search result",
"exclusiveMinimum": 0,
"type": "integer"
},
"locale": {
"description": "Locale for results (default: 'en')",
"type": "string"
},
"page": {
"description": "Page number (default: 1)",
"minimum": 1,
"type": "integer"
},
"perPage": {
"description": "Room types per page, 1-10 (default: 10)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"searchId": {
"description": "Search ID from a previous hotels_search result",
"type": "string"
}
},
"required": [
"hotelId",
"searchId",
"currencyCode"
],
"type": "object"
},
"name": "hotels_get_rooms",
"outputSchema": null
},
{
"description": "Searches for hotel accommodations by city, geo-location, or hotel ID. Not for restaurants, activities, car rentals, or non-travel queries. Use places_find_location first to get codes/IDs/coordinates.\n\nEach hotel price is per night for all rooms in the search together. With 2 rooms, a price covers both rooms.\n\nPolling flow:\n1. First call with search params (no searchId) → creates search session, returns searchId immediately (status: \"created\", pollAgainInSeconds: 5).\n2. Wait pollAgainInSeconds, then call again with searchId → returns hotel results with status \"incomplete\" (better rates still arriving, pollAgainInSeconds says when to call again) or \"complete\" (all providers have answered).\n3. While status is \"incomplete\", wait pollAgainInSeconds and call again. Stop when status is \"complete\". If it is still \"incomplete\" after 3 reads, use the results you have.\n\nOnce a search is complete, every read (new filters, sorting or pagination) returns status \"complete\" at once.\n\nSearch types (one per new search):\n1. citySearch — Hotels in a city. Suitable for generic proximity queries (e.g., \"near airports\" or \"downtown\") when combined with sorting.\n2. geoSearch — Hotels near a specific named location. Suitable when the user specifies a particular airport, landmark, or POI. Recommended radius: 10km for landmarks, 20km for airports.\n3. hotelSearch — Single hotel by ID.\n\nProximity guidance:\n- Generic proximity (e.g., \"hotels near airport\") → citySearch + \"distance_from_nearest_airport_asc\" sorting\n- Generic city center (e.g., \"downtown hotels\") → citySearch + \"distance_from_center_asc\" sorting\n- Named location (e.g., \"hotels near Changi Airport\") → geoSearch with POI coordinates + \"distance_asc\" sorting\n- Explicit radius (e.g., \"hotels within 15km of Eiffel Tower\") → geoSearch with POI coordinates and radius\n\nIntegration with places_find_location:\n- citySearch: get cityCode with types=[\"city\"]\n- geoSearch: get coordinates with types=[\"poi\"]\n\nExamples:\nNew search: { citySearch: { cityCode: \"DXB\" }, checkIn: \"2025-11-06\", checkOut: \"2025-11-07\", rooms: [{ adultsCount: 2, childrenCount: 0 }], sorting: \"price_asc\", currencyCode: \"USD\" }\nRefinement: { searchId: \"abc123\", filters: { starRating: { min: 4 } }, sorting: \"price_asc\", currencyCode: \"USD\" }\n\nRefinement: Provide the searchId from a previous response with updated filters, sorting, or pagination. Refinement replaces all previous filters — re-include existing ones to keep them.\n\nSorting (string): \"relevance\" (default), \"price_asc\", \"price_desc\", \"star_rating_asc\", \"star_rating_desc\", \"review_score_asc\", \"review_score_desc\", \"distance_asc\", \"distance_from_center_asc\", \"distance_from_nearest_airport_asc\"\n\nFilters (flat object):\n- amenities: hotel property amenities (wifi, pool, parking, gym, etc.)\n- roomAmenities: room-level features (bathtub, balcony, minibar, free cancellation)\n- starRating: { min?, max? } — star rating range (0-5)\n- reviewScore: { min?, max? } — guest review score (0-10)\n- priceRange: { min?, max? } — price per night for all rooms together (multiply a per-room budget by the number of rooms)\n- propertyTypes: accommodation type (Hotel, Resort, Apartment, etc.)\n- brands: hotel brand names (Holiday Inn, Hampton, etc.)\n- chains: parent chains (Marriott, IHG, Hilton, etc.)\n\nFilter options: a page 1 read with searchId carries filterOptions with the amenities, roomAmenities, brands, chains and propertyTypes of this search, partial while status is \"incomplete\" and final when status is \"complete\". Page 2 and later reads have no filterOptions. Each entry is { name, count }, where count is the approximate number of hotels in the whole search with that value, before filters. Amenity counts can be lower than the real number. Every listed name is a valid value for the filter of the same name. Use these names in filters on the next read instead of guessing.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkIn": {
"description": "Check-in date in YYYY-MM-DD.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"checkOut": {
"description": "Check-out date in YYYY-MM-DD.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"citySearch": {
"additionalProperties": false,
"description": "Hotels in a city (e.g., 'hotels in Dubai' = {cityCode: 'DXB'}).",
"properties": {
"cityCode": {
"description": "City code (IATA format, e.g., 'DXB', 'SIN')",
"type": "string"
}
},
"required": [
"cityCode"
],
"type": "object"
},
"currencyCode": {
"description": "The currency the user pays in, as an ISO 4217 code (e.g. 'SAR', 'INR', 'USD'): the one they ask for, else the currency of their own country (siteCode). Do NOT take it from the destination: a user in India booking Dubai pays in 'INR'. Send the same code on every flight and hotel call in this conversation, searchId reads included.",
"type": "string"
},
"filters": {
"additionalProperties": false,
"description": "Filters to apply to search results.",
"properties": {
"amenities": {
"description": "Hotel property amenities — all must match (AND logic). Covers wifi, pool, parking, gym, spa, beach, restaurant, pet-friendly, etc. Short terms match best (e.g., 'wifi' not 'Free WiFi', 'pool' not 'Swimming Pool'). Fuzzy matching finds the closest match.",
"items": {
"type": "string"
},
"type": "array"
},
"brands": {
"description": "Hotel brand names (OR logic). Short names match best (e.g., 'Holiday Inn' not 'Holiday Inn Express by IHG'). Fuzzy matching finds the closest match.",
"items": {
"type": "string"
},
"type": "array"
},
"chains": {
"description": "Parent hotel chains/groups (OR logic). Short names match best (e.g., 'Marriott' not 'Marriott - Marriott Rewards'). When user says 'Hilton hotels', use chains, not brands.",
"items": {
"type": "string"
},
"type": "array"
},
"priceRange": {
"additionalProperties": false,
"description": "Budget filter on the price per night for all rooms together, in currencyCode. To filter on a per-room budget, multiply it by the number of rooms. For a total-stay budget, divide it by the number of nights. Examples: '2 rooms, under USD 50 for each room per night' = {max: 100}. 'USD 600 for 3 nights, 2 rooms' = {max: 200}.",
"properties": {
"max": {
"description": "Maximum price per night for all rooms together. A negative value becomes 0.",
"type": "number"
},
"min": {
"description": "Minimum price per night for all rooms together. A negative value becomes 0.",
"type": "number"
}
},
"type": "object"
},
"propertyTypes": {
"description": "Accommodation type filter (e.g., 'resorts only' = ['Resort'], 'hotel or apartment' = ['Hotel', 'Apartment']). Short terms match best.",
"items": {
"type": "string"
},
"type": "array"
},
"reviewScore": {
"additionalProperties": false,
"description": "Guest satisfaction filter on 0-10 scale (e.g., 'highly rated' = {min: 8}).",
"properties": {
"max": {
"description": "Maximum guest review score (will be clamped to 0-10 range)",
"type": "number"
},
"min": {
"description": "Minimum guest review score (will be clamped to 0-10 range)",
"type": "number"
}
},
"type": "object"
},
"roomAmenities": {
"description": "Room-level amenities — all must match (AND logic). Covers room-specific features like 'bathtub', 'balcony', 'minibar', 'kitchen', 'free cancellation'. NOT for property-wide facilities (wifi, pool, gym) — those go in amenities.",
"items": {
"type": "string"
},
"type": "array"
},
"starRating": {
"additionalProperties": false,
"description": "Hotel class filter (e.g., '4-star or above' = {min: 4}, '3 to 4 stars' = {min: 3, max: 4}).",
"properties": {
"max": {
"description": "Maximum star rating (will be clamped to 0-5 range)",
"type": "integer"
},
"min": {
"description": "Minimum star rating (will be clamped to 0-5 range)",
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
"geoSearch": {
"additionalProperties": false,
"description": "Hotels near a location (e.g., 'near Eiffel Tower' = {latitude: 48.8584, longitude: 2.2945}). Use places_find_location for coordinates.",
"properties": {
"latitude": {
"description": "Latitude coordinate (will be clamped to -90 to 90 range)",
"type": "number"
},
"longitude": {
"description": "Longitude coordinate (will be clamped to -180 to 180 range)",
"type": "number"
},
"name": {
"description": "Name of the reference point for display (e.g., 'Burj Khalifa', 'Mall of the Emirates')",
"type": "string"
},
"radius": {
"description": "Search radius in kilometers (minimum 10km enforced). Recommended values: 10km for city landmarks, 20km for airports, 30km for rural areas",
"type": "number"
}
},
"required": [
"longitude",
"latitude"
],
"type": "object"
},
"hotelSearch": {
"additionalProperties": false,
"description": "Single hotel by ID (e.g., {hotelId: 12345}).",
"properties": {
"hotelId": {
"description": "Hotel ID for single hotel search",
"type": "integer"
}
},
"required": [
"hotelId"
],
"type": "object"
},
"locale": {
"description": "Locale code (e.g., 'en', 'ar'). Default: 'en'.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"default": {
"page": 1,
"perPage": 8
},
"description": "Pagination settings",
"properties": {
"page": {
"default": 1,
"description": "Page number for pagination (will be clamped to minimum 1)",
"type": "integer"
},
"perPage": {
"default": 8,
"description": "Number of results per page (will be clamped to 1-100 range)",
"type": "integer"
}
},
"type": "object"
},
"rooms": {
"description": "Room config (e.g., [{adultsCount: 2, childrenCount: 1, childrenAges: [8]}]). REQUIRED when childrenCount > 0: ask for ages before searching.",
"items": {
"additionalProperties": false,
"properties": {
"adultsCount": {
"description": "Number of adults in the room (will be clamped to minimum 1)",
"type": "integer"
},
"childrenAges": {
"description": "Ages of each child (0-17). REQUIRED when childrenCount > 0 — if the user hasn't specified ages, ask them before searching. Do NOT guess or infer ages from other numbers like dates. Array format even for one child, e.g., [8] not 8.",
"items": {
"type": "integer"
},
"type": "array"
},
"childrenCount": {
"description": "Number of children in the room (will be clamped to minimum 0)",
"type": "integer"
}
},
"required": [
"adultsCount",
"childrenCount"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"searchId": {
"description": "Reuse the searchId from a previous search when refining filters or sorting.",
"type": "string"
},
"siteCode": {
"description": "The user's OWN country as an ISO 3166-1 alpha-2 code (e.g. 'SG', 'SA', 'IN'), when the conversation shows where the user is. It picks the Wego site that booking links open and the market prices come from. Do NOT take it from the departure, arrival or hotel city: a user in India searching London is still 'IN'. Omit it when unknown (default 'US'). Set it when the search is created; a searchId read keeps the search's site.",
"pattern": "^(?:[A-Z]{2})?$",
"type": "string"
},
"sorting": {
"default": "relevance",
"description": "Sort order (e.g., 'cheapest first' = 'price_asc', 'closest to center' = 'distance_from_center_asc'). Default: relevance.",
"enum": [
"relevance",
"price_asc",
"price_desc",
"star_rating_asc",
"star_rating_desc",
"review_score_asc",
"review_score_desc",
"distance_asc",
"distance_from_center_asc",
"distance_from_nearest_airport_asc"
],
"type": "string"
}
},
"required": [
"currencyCode"
],
"type": "object"
},
"name": "hotels_search",
"outputSchema": null
},
{
"description": "Search for cities, airports, districts, states, hotels, or points of interest by name. Returns location codes, IDs, and coordinates. Supports pagination (default: 10 results per page).\n\nPLACE TYPES:\nFilter by specific types using the 'types' parameter:\n- city: Major cities (returns cityCode like \"DXB\", \"PAR\")\n- airport: Airports (returns IATA codes like \"JFK\", \"LHR\")\n- district: Neighborhoods within cities (returns districtId)\n- state: States, provinces, regions\n- hotel: Individual hotels (returns hotelId)\n- poi: Points of interest, landmarks (returns coordinates)\n\nIf 'types' is omitted, returns all matching place types.\n\nPOI SEARCH WITH LOCATION BIAS:\nPOI search uses Google Places API. You can optionally provide locationBias (approximate coordinates) to improve result relevance when geographic context is known.\n\nWhen to provide locationBias:\n- User mentions a city: \"Eiffel Tower in Paris\" (provide Paris coordinates)\n- Previous conversation context provides location\n- You recognize the landmark location\n\nWhen NOT to provide locationBias:\n- No geographic context available\n- Uncertain about location\n- Global/ambiguous landmarks\n\nEXAMPLES:\nFind city: { query: \"Dubai\" } returns cityCode: \"DXB\"\nFind district: { query: \"Downtown Dubai\", types: [\"district\"] } returns districtId\nFind airports: { query: \"New York\", types: [\"airport\"] } returns JFK, LGA, EWR\nFind hotel: { query: \"Burj Al Arab\", types: [\"hotel\"] } returns hotelId\nFind POI with bias: { query: \"Eiffel Tower\", types: [\"poi\"], locationBias: { latitude: 48.85, longitude: 2.35 } }\nFind POI without bias: { query: \"Marina Bay Sands\", types: [\"poi\"] }\nPagination: { query: \"hotel\", pageSize: 10, page: 2 } returns results 11-20\n\nAMBIGUITY HANDLING:\nWhen multiple locations match, response includes hasAmbiguity: true and disambiguationHint. Ask user to specify which location.\n\nNOTES:\n- locationBias is optional (text search works without it)\n- Approximate coordinates are fine (city-level accuracy)\n- Location bias improves relevance but doesn't exclude other regions",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"locale": {
"description": "Locale code for localized results (falls back to user's locale from platform metadata)",
"type": "string"
},
"locationBias": {
"additionalProperties": false,
"description": "Optional coordinates to bias POI search results. Useful when searching for landmarks in a specific region. The LLM can provide approximate city/region coordinates based on context.",
"properties": {
"latitude": {
"description": "Latitude for location bias (helps narrow POI search results)",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Longitude for location bias (helps narrow POI search results)",
"maximum": 180,
"minimum": -180,
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"page": {
"default": 1,
"description": "Page number for pagination (default: 1)",
"minimum": 1,
"type": "integer"
},
"pageSize": {
"default": 10,
"description": "Number of results per page (default: 10, max: 50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Search query for the location",
"minLength": 1,
"type": "string"
},
"types": {
"description": "Array of place types to filter results. If omitted, returns all types.",
"items": {
"enum": [
"city",
"airport",
"state",
"district",
"hotel",
"poi"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "places_find_location",
"outputSchema": null
},
{
"description": "Finds the nearest airport to given coordinates. Returns airport IATA code, name, and distance. Useful for determining departure airport when only coordinates are known.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"latitude": {
"description": "Latitude coordinate",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"locale": {
"description": "Locale for localized names (defaults to 'en')",
"type": "string"
},
"longitude": {
"description": "Longitude coordinate",
"maximum": 180,
"minimum": -180,
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"name": "places_get_nearest_airport",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e2d7b88524f357cb19615da13b678e762ae484f811eff91d6e36330327afdb1e | sha256sum