jinko-mcp

Initiate hotel reservation and generate secure payment link. Creates a booking quote and provides a payment URL for the user to complete their reservation.

WHEN TO USE: Use this tool when: • User has selected a specific hotel and rate to book • User is ready to proceed with reservation • You have valid session_id, hotel_id, and rate_id from search/detail results

IMPORTANT: This tool creates a booking quote but does NOT process payment directly. Users must complete payment through the provided link to confirm their reservation.

REQUIRED PARAMETERS: • session_id: Session ID from a recent search-hotels or semantic-search-hotels call • hotel_id: Unique identifier of the hotel to book (from search results) • room_id: Specific room ID to reserve (from search or detail results) • rate_id: Specific rate/room offer ID to reserve (from search or detail results)

OPTIONAL PARAMETER: • guest_info: Guest information and preferences (name, contact, special requests)

BOOKING PROCESS:

Step 1 - Quote Creation: This tool sends a booking request to the hotel provider and creates a reservation quote with: • Selected hotel and room details • Final pricing including all taxes and fees • Booking terms and conditions • Cancellation policy specific to this rate

Step 2 - Payment Link Generation: Returns a secure, time-limited payment URL where the user can: • Review final booking details • Enter payment information securely • Complete the reservation • Receive booking confirmation

Step 3 - User Action Required: • Present the payment link prominently to the user • Inform user that reservation is NOT confirmed until payment is processed • Note that payment links typically expire within 24-48 hours • Advise checking email for confirmation after payment

WHAT YOU GET BACK: • Booking reference/quote ID • Payment link URL (secure HTTPS) • Quote expiration time • Final price breakdown • Booking terms summary • Hotel and room details confirmation

USAGE GUIDELINES: ✓ Always verify hotel_id and rate_id match the user's selection ✓ Use fresh search results (recent session_id) for accurate availability and pricing ✓ Clearly explain to users that they must complete payment to confirm booking ✓ Remind users to check their email for booking confirmation after payment ✓ Note any time sensitivity (quote expiration, limited availability)

IMPORTANT REMINDERS: • Payment is NOT processed by this tool - it only generates the payment link • Booking is NOT confirmed until user completes payment through the link • Session_id, hotel_id, and rate_id must all be from recent, active searches • Payment links expire - users should complete payment promptly • Booking availability and pricing may change if session expires

OUTPUT: Returns structured booking quote data including payment URL, booking reference, pricing details, and instructions for completing the reservation. The payment link is the critical output that must be provided to the user.

Retrieve reference data for hotel search filter options. Returns structured metadata for facilities, hotel types, and meal plans with IDs and descriptions.

WHEN TO USE: Call this tool when you need to: • Understand available filtering options before performing a search • Get facility/amenity IDs to use in search-hotels or semantic-search-hotels • Look up hotel type IDs for property type filtering • Reference meal plan codes and descriptions • Provide users with available filter categories

NO PARAMETERS REQUIRED: This tool requires no input parameters. It returns a comprehensive reference dataset.

RETURNED METADATA:

1. FACILITIES (Amenities): Complete list of hotel facilities with unique IDs for filtering: • WiFi (ID: 47, 107) - Internet connectivity • Swimming Pool (ID: 433) - Pool access • Fitness Center/Gym (ID: 457, 493) - Exercise facilities • Parking (ID: 19, 20, 21) - Various parking options • Restaurant (ID: 89) - On-site dining • Spa (ID: 325) - Wellness facilities • Pet-Friendly (ID: 456) - Allows pets ...and many more amenities

2. HOTEL TYPES: Property classification IDs for type filtering: • Hotels (ID: 204) - Standard hotel properties • Resorts (ID: 206) - Resort properties • Apartments (ID: 201) - Apartment-style accommodations • Villas (ID: 213) - Villa properties • Hostels (ID: 203) - Budget hostels • Bed & Breakfasts (ID: 208) - B&B properties ...and other property types

3. BOARD TYPES (Meal Plans): Meal plan codes and descriptions: • RO - Room Only (no meals included) • BB - Bed & Breakfast (breakfast included) • HB - Half Board (breakfast + dinner) • FB - Full Board (all meals) • AI - All Inclusive (meals + drinks)

USAGE EXAMPLE: After calling this tool, use the returned facility_ids and hotel_type_ids arrays in your search-hotels calls: { "location": "Paris", "facility_ids": [47, 433, 457], // WiFi, Pool, Gym "hotel_type_ids": [204], // Hotels only "board_type": "BB" // Breakfast included }

OUTPUT: Returns structured JSON with three main sections: facilities array, hotelTypes array, and boardTypes array. Each entry includes ID, name, description, and additional metadata for proper usage.

Retrieve comprehensive details for a specific hotel from search results. Returns complete property information including rooms, rates, policies, and amenities.

WHEN TO USE: Use this tool when a user wants to: • View detailed information about a specific hotel from search results • Compare room types and rates within a single property • Review cancellation policies and booking terms • Check complete amenity list and property facilities • Get detailed descriptions before booking

REQUIRED PARAMETERS: • session_id: Session ID from a recent search-hotels or semantic-search-hotels call • hotel_id: Unique hotel identifier from the search results

IMPORTANT: Both parameters must be from recent, active searches. Sessions expire after periods of inactivity. Always use fresh search results to ensure valid session and hotel IDs.

DETAILED INFORMATION RETURNED:

Property Overview: • Full hotel name, description, and category • Star rating and guest review scores • Complete address and location details • Contact information • Check-in/check-out times and policies

Facilities & Amenities: • Complete list of hotel facilities (WiFi, pool, gym, spa, parking, etc.) • Room-specific amenities by room type • Accessibility features • On-site services and activities

Room Types & Configurations: • All available room categories • Room size and layout details • Bed configurations (king, queen, twin, etc.) • Maximum occupancy per room • Room-specific facilities

Rate Information: • Multiple rate options per room type • Detailed pricing breakdown • Meal plan inclusions (Room Only, Breakfast, Half Board, etc.) • Rate comparison across booking conditions • Special offers and packages • Taxes and fees breakdown

Booking Policies: • Cancellation policies and deadlines • Refundability conditions and penalties • Payment terms and requirements • Hotel-specific booking rules • Age restrictions and requirements • Pet policies

Location Details: • Nearby attractions and landmarks • Distance to airport/transit • Neighborhood description

OUTPUT: Returns structured JSON with comprehensive hotel data organized by sections. Use this information to help users make informed booking decisions. The hotel_id and session_id are required for the book-hotel tool.

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.

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).