book-hotel

Instructions

Implementation Reference

• src/hotel-mcp/tools/standard/booking.ts:9-79 (handler)

  The bookHotel function implements the core logic for booking a hotel. It schedules a booking quote via API, polls for status, generates a payment link, and returns formatted booking details or processing status.

  export async function bookHotel(params: { session_id: string, hotel_id: string; rate_id: string }) {
      // Create quote request
      const quoteRequest = {
        products: [
          {
            product_type: "hotel",
            hotel_id: params.hotel_id,
            search_session_id: params.session_id,
            rate_id: params.rate_id,
          },
        ],
      };
    
      // Schedule quote
      const scheduleResponse = await makeApiRequest<any>(
        "/api/v1/booking/quote/schedule",
        "POST",
        quoteRequest
      );
    
      if (!scheduleResponse || !scheduleResponse.reference) {
        return createYamlResponse({
          status: "error",
          message: "Failed to schedule quote. Please try again later."
        });
      }
    
      const quoteId = scheduleResponse.reference;
    
      // Poll for quote status
      const quoteResult = await pollForQuoteStatus(quoteId);
    
        // Format quote information
      const paymentLink = `https://app.jinko.so/checkout/${quoteId}`;
    
      if (!quoteResult) {
        return createYamlResponse({
          status: "processing",
          message: `Your booking request is being processed. Please inform the user that they can proceed to complete their booking using the payment link provided below. The booking details will be finalized during the payment process.`,
          payment_link: paymentLink,
          quote_id: quoteId
        });
      }
    
      let productInfo = {
        status: "success",
        action: "N/A",
        hotel: "Unknown hotel",
        check_in: "N/A",
        check_out: "N/A",
        total_price: "N/A",
        payment_link: paymentLink,
        quote_id: quoteId
      };
    
      if (quoteResult.quoted_products && quoteResult.quoted_products.length > 0) {
        const product = quoteResult.quoted_products[0];
        productInfo = {
          status: "success",
          action: "IMPORTANT: Present the payment_link to the user so they can complete their booking by clicking the link and processing payment.",
          hotel: product.hotel_name || "Unknown hotel",
          check_in: product.check_in_date,
          check_out: product.check_out_date,
          total_price: `${product.rate_info.selling_price?.amount || "N/A"} ${product.rate_info.selling_price?.currency || "USD"}`,
          payment_link: paymentLink,
          quote_id: quoteId
        };
      }
    
      return createYamlResponse(productInfo);
  }

• src/hotel-mcp/server/standard.ts:139-143 (schema)

  Zod input schema defining parameters for the book-hotel tool: session_id, hotel_id, and rate_id.

  {
    session_id: z.string().describe("The session ID from a previous search"),
    hotel_id: z.string().describe("ID of the hotel to book"),
    rate_id: z.string().describe("ID of the specific rate option the user has selected"),
  },

• src/hotel-mcp/server/standard.ts:127-145 (registration)

  Registration of the 'book-hotel' tool on the MCP server, specifying name, description, input schema, and handler (with telemetry instrumentation).

  server.tool(
    "book-hotel",
    `Initiate a hotel booking process for a specific hotel and rate option.
  
  IMPORTANT WORKFLOW:
  1. Before calling this tool, you MUST present a specific hotel's all available rate options to the user using get-hotel-details
  2. The user MUST select a specific rate option they want to book
  3. This tool will generate a secure payment link that the user needs to open in their browser to complete the booking
  
  The response includes a payment_link that must be prominently displayed to the user, along with
  booking details such as hotel name, check-in/out dates, and total price.
  `,
    {
      session_id: z.string().describe("The session ID from a previous search"),
      hotel_id: z.string().describe("ID of the hotel to book"),
      rate_id: z.string().describe("ID of the specific rate option the user has selected"),
    },
    getTelemetry().telemetryMiddleware.instrumentTool("book-hotel", bookHotel),
  );