hotels MCP tools

Find available hotels by location coordinates and booking details. Retrieve key hotel information, including name, address, star rating, price range, and room types. Use session_id for additional results beyond the initial 50.

Search for hotels with structured filtering parameters. Returns an interactive widget showing hotel results with images, pricing, ratings, and amenities. WHEN TO USE: Use this tool when you have structured search criteria with specific filters (location, dates, amenities, price range, star rating). For natural language queries like "pet-friendly hotel with pool in Paris", use semantic-search-hotels instead. REQUIRED PARAMETERS: • location: City, region, or area name (e.g., "Paris", "Manhattan NYC", "Tokyo Shibuya") • check_in_date: Check-in date in YYYY-MM-DD format • check_out_date: Check-out date in YYYY-MM-DD format • adults: Number of adult guests (minimum 1) OPTIONAL FILTERS: • children: Array of children ages (e.g., [8, 12] for two children) • infants: Number of infants under 2 years • facility_ids: Filter by amenities (pool, gym, WiFi, parking - use get-filtering-metadata for IDs) • hotel_type_ids: Filter by property type (hotel, resort, apartment - use get-filtering-metadata for IDs) • min_star_rating: Minimum star rating 1-5 • min_rating: Minimum guest rating 0-10 • max_price: Maximum price per night in specified currency • board_type: Meal plan (RO=Room Only, BB=Breakfast, HB=Half Board, FB=Full Board, AI=All Inclusive) • refundable_only: Set true to show only refundable rates • currency: Price currency (default: USD) • language: Result language (default: en_US) • market: Regional pricing preference OUTPUT: Returns structured hotel data including name, location, pricing, ratings, images, and key amenities. Results are displayed in an interactive table widget with sorting and filtering. Includes session_id for pagination (load-more-hotels) and detail viewing (get-hotel-details).

Retrieve the next batch of hotel results from a previous search using the session_id. This tool extends pagination to fetch additional properties with consistent formatting and details, indicating if more data is available.

Load additional hotel results from a previous search. Returns the next page of hotels using the same search criteria and filters. WHEN TO USE: Use this tool when: • Previous search results indicated more hotels are available (has_more: true) • User wants to see additional options beyond initial results • Browsing through paginated search results • Expanding search results without changing filters REQUIRED PARAMETER: • session_id: Session ID from a previous search-hotels or semantic-search-hotels response HOW IT WORKS: This tool continues pagination from where the previous search left off, automatically maintaining: • Original search parameters (location, dates, guest counts) • All applied filters (facilities, price, ratings, hotel types) • Semantic query context (for AI-powered searches) • Current pagination state and offset NO NEED TO REPEAT: You do NOT need to re-specify the original search filters, location, dates, or any other parameters. The session maintains all search context. RESPONSE FORMAT: Returns the same structured format as the original search tool: • List of hotels with names, prices, ratings, images, and amenities • Interactive widget showing results in a table format • Pagination indicator (has_more) showing if additional results exist • Same session_id for subsequent pagination or detail requests IMPORTANT: • Session_id must be from a recent, active search operation • Sessions may expire after extended periods of inactivity • Works seamlessly with both search-hotels and semantic-search-hotels sessions • Check has_more field in response to determine if further pagination is possible TYPICAL USAGE FLOW: 1. User performs search (search-hotels or semantic-search-hotels) 2. Results show has_more: true 3. User requests more options 4. Call load-more-hotels with the session_id 5. Repeat as needed while has_more remains true OUTPUT: Returns structured hotel data in interactive widget format, identical to the original search results. Includes updated pagination state and session_id for continued browsing.

Find hotels, restaurants, and attractions on Tripadvisor by searching with keywords, categories, addresses, or coordinates.

Find hotels, restaurants, and attractions on Tripadvisor by searching with keywords, categories, addresses, or coordinates.