hotelzero 1.0.0 → 1.1.0

package/README.md

@@ -100,13 +100,16 @@ Get detailed information about a specific hotel including full amenity list, des
 | `checkOut` | string | Yes | Check-out date (YYYY-MM-DD) |
 | `guests` | number | No | Number of guests (default: 2) |
 | `rooms` | number | No | Number of rooms (default: 1) |
+| `currency` | string | No | Currency code (USD, EUR, GBP, JPY, etc.) Default: USD |
+| `sortBy` | enum | No | Sort results: `popularity`, `price_lowest`, `price_highest`, `rating`, `distance` |
 
 ### Rating & Price
 
 | Filter | Type | Description |
 |--------|------|-------------|
 | `minRating` | number | Minimum review score: 6=Pleasant, 7=Good, 8=Very Good, 9=Wonderful |
-| `maxPrice` | number | Maximum price per night in USD (client-side filter) |
+| `minPrice` | number | Minimum price per night |
+| `maxPrice` | number | Maximum price per night |
 
 ### Property Type
 

package/dist/browser.d.ts

@@ -4,9 +4,12 @@ export interface HotelSearchParams {
     checkOut: string;
     guests: number;
     rooms: number;
+    currency?: string;
+    sortBy?: "popularity" | "price_lowest" | "price_highest" | "rating" | "distance";
 }
 export interface HotelFilters {
     minRating?: number;
+    minPrice?: number;
     maxPrice?: number;
     propertyType?: "hotel" | "apartment" | "resort" | "villa" | "vacation_home" | "hostel" | "bnb" | "guesthouse" | "homestay" | "motel" | "inn" | "lodge" | "chalet" | "campground" | "glamping" | "boat" | "capsule" | "ryokan" | "riad" | "country_house" | "farm_stay";
     starRating?: 1 | 2 | 3 | 4 | 5;
@@ -99,6 +102,8 @@ export interface HotelResult {
     amenities: string[];
     highlights: string[];
     link: string;
+    thumbnailUrl: string | null;
+    availability: string | null;
     matchScore?: number;
     matchReasons?: string[];
 }

package/dist/browser.js

@@ -191,14 +191,28 @@ export class HotelBrowser {
         }
     }
     buildBookingUrl(params, filters) {
-        const { destination, checkIn, checkOut, guests, rooms } = params;
+        const { destination, checkIn, checkOut, guests, rooms, currency, sortBy } = params;
         const url = new URL("https://www.booking.com/searchresults.html");
         url.searchParams.set("ss", destination);
         url.searchParams.set("checkin", checkIn);
         url.searchParams.set("checkout", checkOut);
         url.searchParams.set("group_adults", guests.toString());
         url.searchParams.set("no_rooms", rooms.toString());
-        url.searchParams.set("selected_currency", "USD");
+        url.searchParams.set("selected_currency", currency || "USD");
+        // Sort order
+        if (sortBy) {
+            const sortMap = {
+                popularity: "popularity",
+                price_lowest: "price",
+                price_highest: "price",
+                rating: "review_score_and_price",
+                distance: "distance_from_search",
+            };
+            url.searchParams.set("order", sortMap[sortBy] || "popularity");
+            if (sortBy === "price_highest") {
+                url.searchParams.set("sort_order", "desc");
+            }
+        }
         if (!filters)
             return url.toString();
         const nfltParts = [];
@@ -557,6 +571,24 @@ export class HotelBrowser {
                     highlights.push("Free Cancellation");
                 if (cardText.includes("no prepayment"))
                     highlights.push("No Prepayment");
+                // Extract thumbnail image URL
+                const imgEl = card.querySelector('img[data-testid="image"]');
+                const thumbnailUrl = imgEl?.src || null;
+                // Extract availability status (e.g., "Only 2 rooms left", "Last booked 5 minutes ago")
+                let availability = null;
+                const availabilityPatterns = [
+                    /only\s*\d+\s*(rooms?|left)/i,
+                    /last\s*(booked|reserved)\s*\d+\s*(minutes?|hours?)\s*ago/i,
+                    /in\s*high\s*demand/i,
+                    /selling\s*fast/i,
+                ];
+                for (const pattern of availabilityPatterns) {
+                    const match = cardText.match(pattern);
+                    if (match) {
+                        availability = match[0];
+                        break;
+                    }
+                }
                 results.push({
                     name,
                     price,
@@ -569,6 +601,8 @@ export class HotelBrowser {
                     amenities,
                     highlights,
                     link,
+                    thumbnailUrl,
+                    availability,
                 });
             });
             return results;
@@ -682,6 +716,9 @@ export class HotelBrowser {
             if (filters.minRating && hotel.rating && hotel.rating < filters.minRating) {
                 return false;
             }
+            if (filters.minPrice && hotel.price && hotel.price < filters.minPrice) {
+                return false;
+            }
             if (filters.maxPrice && hotel.price && hotel.price > filters.maxPrice) {
                 return false;
             }

package/dist/index.js

@@ -37,9 +37,13 @@ const FindHotelsSchema = z.object({
     checkOut: z.string().describe("Check-out date (YYYY-MM-DD)"),
     guests: z.number().default(2).describe("Number of guests"),
     rooms: z.number().default(1).describe("Number of rooms"),
+    // Currency & Sorting
+    currency: z.string().optional().describe("Currency code (USD, EUR, GBP, JPY, etc.)"),
+    sortBy: z.enum(["popularity", "price_lowest", "price_highest", "rating", "distance"]).optional().describe("Sort results by"),
     // Rating & Price
     minRating: z.number().optional().describe("Minimum rating (6=Pleasant, 7=Good, 8=Very Good, 9=Wonderful)"),
-    maxPrice: z.number().optional().describe("Maximum price per night in USD"),
+    minPrice: z.number().optional().describe("Minimum price per night"),
+    maxPrice: z.number().optional().describe("Maximum price per night"),
     // Property & Star Rating
     propertyType: PropertyTypeEnum.optional().describe("Type of property (hotel, resort, apartment, villa, etc.)"),
     starRating: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4), z.literal(5)]).optional().describe("Star rating (1-5)"),
@@ -136,6 +140,9 @@ function formatHotelResult(hotel, index) {
     if (hotel.distanceToCenter) {
         lines.push(`   Location: ${hotel.distanceToCenter}`);
     }
+    if (hotel.availability) {
+        lines.push(`   Availability: ${hotel.availability}`);
+    }
     if (hotel.amenities.length > 0) {
         lines.push(`   Amenities: ${hotel.amenities.join(", ")}`);
     }
@@ -145,6 +152,9 @@ function formatHotelResult(hotel, index) {
             lines.push(`   Why it matches: ${hotel.matchReasons.join(", ")}`);
         }
     }
+    if (hotel.thumbnailUrl) {
+        lines.push(`   Image: ${hotel.thumbnailUrl}`);
+    }
     if (hotel.link) {
         // Shorten link for readability
         const shortLink = hotel.link.split("?")[0];
@@ -154,8 +164,8 @@ function formatHotelResult(hotel, index) {
 }
 // Create MCP server
 const server = new Server({
-    name: "hotel-booking-mcp",
-    version: "2.0.0",
+    name: "hotelzero",
+    version: "1.1.0",
 }, {
     capabilities: {
         tools: {},
@@ -173,7 +183,15 @@ const findHotelsInputSchema = {
         rooms: { type: "number", description: "Number of rooms", default: 1 },
         // Rating & Price
         minRating: { type: "number", description: "Minimum rating: 6=Pleasant, 7=Good, 8=Very Good, 9=Wonderful" },
-        maxPrice: { type: "number", description: "Maximum price per night in USD" },
+        minPrice: { type: "number", description: "Minimum price per night" },
+        maxPrice: { type: "number", description: "Maximum price per night" },
+        // Currency & Sorting
+        currency: { type: "string", description: "Currency code (USD, EUR, GBP, JPY, etc.)", default: "USD" },
+        sortBy: {
+            type: "string",
+            description: "Sort results by",
+            enum: ["popularity", "price_lowest", "price_highest", "rating", "distance"]
+        },
         // Property Type
         propertyType: {
             type: "string",
@@ -333,11 +351,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     checkOut: parsed.checkOut,
                     guests: parsed.guests,
                     rooms: parsed.rooms,
+                    currency: parsed.currency,
+                    sortBy: parsed.sortBy,
                 };
                 // Build filters object from all parsed parameters
                 const filters = {};
                 // Copy all filter properties
-                const filterKeys = Object.keys(parsed).filter(k => !['destination', 'checkIn', 'checkOut', 'guests', 'rooms'].includes(k));
+                const filterKeys = Object.keys(parsed).filter(k => !['destination', 'checkIn', 'checkOut', 'guests', 'rooms', 'currency', 'sortBy'].includes(k));
                 for (const key of filterKeys) {
                     const value = parsed[key];
                     if (value !== undefined && value !== null) {
@@ -389,6 +409,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     activeFilters.push(parsed.hotelChain);
                 if (parsed.minRating)
                     activeFilters.push(`rating ≥${parsed.minRating}`);
+                if (parsed.minPrice)
+                    activeFilters.push(`≥$${parsed.minPrice}/night`);
                 if (parsed.maxPrice)
                     activeFilters.push(`≤$${parsed.maxPrice}/night`);
                 if (parsed.allInclusive)
@@ -399,6 +421,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     activeFilters.push("diving");
                 if (parsed.skiing)
                     activeFilters.push("skiing");
+                if (parsed.currency && parsed.currency !== "USD")
+                    activeFilters.push(`currency: ${parsed.currency}`);
+                if (parsed.sortBy)
+                    activeFilters.push(`sorted by: ${parsed.sortBy.replace("_", " ")}`);
                 const filtersLine = activeFilters.length > 0
                     ? `Filters: ${activeFilters.join(", ")}\n\n`
                     : "\n";
@@ -486,7 +512,7 @@ process.on("SIGTERM", async () => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("HotelZero v1.0.0 running on stdio");
+    console.error("HotelZero v1.1.0 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "hotelzero",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for searching hotels on Booking.com with 80+ filters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "bin": {
-    "hotelzero": "./dist/index.js"
+    "hotelzero": "dist/index.js"
   },
   "files": [
     "dist"