hotelzero 1.0.0 → 1.2.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

@@ -1,12 +1,31 @@
+export declare class HotelSearchError extends Error {
+    code: string;
+    retryable: boolean;
+    constructor(message: string, code: string, retryable?: boolean);
+}
+export declare const ErrorCodes: {
+    readonly BROWSER_NOT_INITIALIZED: "BROWSER_NOT_INITIALIZED";
+    readonly NAVIGATION_FAILED: "NAVIGATION_FAILED";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly CAPTCHA_DETECTED: "CAPTCHA_DETECTED";
+    readonly NO_RESULTS: "NO_RESULTS";
+    readonly DESTINATION_NOT_FOUND: "DESTINATION_NOT_FOUND";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly BLOCKED: "BLOCKED";
+};
 export interface HotelSearchParams {
     destination: string;
     checkIn: string;
     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,15 +118,22 @@ export interface HotelResult {
     amenities: string[];
     highlights: string[];
     link: string;
+    thumbnailUrl: string | null;
+    availability: string | null;
     matchScore?: number;
     matchReasons?: string[];
 }
 export declare class HotelBrowser {
     private browser;
     private page;
+    private lastRequestTime;
+    private minRequestIntervalMs;
     init(headless?: boolean): Promise<void>;
     close(): Promise<void>;
     private buildBookingUrl;
+    private enforceRateLimit;
+    private checkForBlocking;
+    private checkForNoResults;
     searchHotels(params: HotelSearchParams, filters?: HotelFilters): Promise<HotelResult[]>;
     private dismissPopups;
     private scrollToLoadMore;

package/dist/browser.js

@@ -1,4 +1,62 @@
 import { chromium } from "playwright";
+// Custom error types for better error handling
+export class HotelSearchError extends Error {
+    code;
+    retryable;
+    constructor(message, code, retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "HotelSearchError";
+    }
+}
+export const ErrorCodes = {
+    BROWSER_NOT_INITIALIZED: "BROWSER_NOT_INITIALIZED",
+    NAVIGATION_FAILED: "NAVIGATION_FAILED",
+    RATE_LIMITED: "RATE_LIMITED",
+    CAPTCHA_DETECTED: "CAPTCHA_DETECTED",
+    NO_RESULTS: "NO_RESULTS",
+    DESTINATION_NOT_FOUND: "DESTINATION_NOT_FOUND",
+    NETWORK_ERROR: "NETWORK_ERROR",
+    TIMEOUT: "TIMEOUT",
+    BLOCKED: "BLOCKED",
+};
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 10000,
+};
+// Sleep helper
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+// Retry with exponential backoff
+async function retryWithBackoff(fn, config = DEFAULT_RETRY_CONFIG, onRetry) {
+    let lastError = null;
+    for (let attempt = 1; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry non-retryable errors
+            if (error instanceof HotelSearchError && !error.retryable) {
+                throw error;
+            }
+            // Don't retry on last attempt
+            if (attempt === config.maxRetries) {
+                break;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const exponentialDelay = config.baseDelayMs * Math.pow(2, attempt - 1);
+            const jitter = Math.random() * 1000;
+            const delay = Math.min(exponentialDelay + jitter, config.maxDelayMs);
+            if (onRetry) {
+                onRetry(attempt, lastError, delay);
+            }
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
 // Booking.com filter code mappings
 const FILTER_CODES = {
     // Property Types
@@ -172,6 +230,8 @@ const FILTER_CODES = {
 export class HotelBrowser {
     browser = null;
     page = null;
+    lastRequestTime = 0;
+    minRequestIntervalMs = 2000; // Minimum 2 seconds between requests
     async init(headless = true) {
         this.browser = await chromium.launch({
             headless,
@@ -191,14 +251,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 = [];
@@ -399,23 +473,121 @@ export class HotelBrowser {
         }
         return url.toString();
     }
-    async searchHotels(params, filters) {
+    // Rate limiting: ensure minimum time between requests
+    async enforceRateLimit() {
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.minRequestIntervalMs) {
+            const waitTime = this.minRequestIntervalMs - timeSinceLastRequest;
+            await sleep(waitTime);
+        }
+        this.lastRequestTime = Date.now();
+    }
+    // Check for CAPTCHA or blocking pages
+    async checkForBlocking() {
         if (!this.page)
-            throw new Error("Browser not initialized");
-        const url = this.buildBookingUrl(params, filters);
-        await this.page.goto(url, { waitUntil: "networkidle" });
-        await this.page.waitForTimeout(2000);
-        // Close any popups/modals
-        await this.dismissPopups();
-        // Scroll to load more results
-        await this.scrollToLoadMore();
-        // Extract detailed hotel info
-        const hotels = await this.extractHotelDetails();
-        // Apply client-side filtering and scoring if we have preferences
-        if (filters) {
-            return this.scoreAndFilterHotels(hotels, filters);
+            return;
+        const pageContent = await this.page.content();
+        const pageUrl = this.page.url();
+        // Check for CAPTCHA
+        const captchaIndicators = [
+            "captcha",
+            "recaptcha",
+            "hcaptcha",
+            "challenge-running",
+            "challenge-form",
+            "px-captcha",
+        ];
+        const hasCaptcha = captchaIndicators.some(indicator => pageContent.toLowerCase().includes(indicator));
+        if (hasCaptcha) {
+            throw new HotelSearchError("CAPTCHA detected. Please wait a few minutes before retrying.", ErrorCodes.CAPTCHA_DETECTED, false // Not retryable automatically
+            );
+        }
+        // Check for rate limiting / blocking
+        const blockIndicators = [
+            "access denied",
+            "too many requests",
+            "rate limit",
+            "blocked",
+            "forbidden",
+            "error 403",
+            "error 429",
+        ];
+        const isBlocked = blockIndicators.some(indicator => pageContent.toLowerCase().includes(indicator));
+        if (isBlocked || pageUrl.includes("blocked") || pageUrl.includes("error")) {
+            throw new HotelSearchError("Request blocked by Booking.com. Please wait a few minutes before retrying.", ErrorCodes.BLOCKED, true // Retryable with backoff
+            );
         }
-        return hotels;
+    }
+    // Check if destination was found
+    async checkForNoResults() {
+        if (!this.page)
+            return;
+        const pageContent = await this.page.content();
+        // Check for "no results" or "destination not found" messages
+        const noResultsIndicators = [
+            "no properties found",
+            "no results",
+            "0 properties",
+            "we couldn't find",
+            "try different dates",
+        ];
+        const hasNoResults = noResultsIndicators.some(indicator => pageContent.toLowerCase().includes(indicator));
+        if (hasNoResults) {
+            // Check if it's a destination issue or just no matching filters
+            const destinationIssue = pageContent.toLowerCase().includes("destination") &&
+                (pageContent.toLowerCase().includes("not found") ||
+                    pageContent.toLowerCase().includes("couldn't find"));
+            if (destinationIssue) {
+                throw new HotelSearchError("Destination not found. Please check the spelling and try again.", ErrorCodes.DESTINATION_NOT_FOUND, false);
+            }
+            // No results but destination is valid - this is not an error, just empty results
+        }
+    }
+    async searchHotels(params, filters) {
+        if (!this.page) {
+            throw new HotelSearchError("Browser not initialized. Call init() first.", ErrorCodes.BROWSER_NOT_INITIALIZED, false);
+        }
+        const url = this.buildBookingUrl(params, filters);
+        // Use retry with exponential backoff for the main search operation
+        return await retryWithBackoff(async () => {
+            // Enforce rate limiting
+            await this.enforceRateLimit();
+            try {
+                await this.page.goto(url, {
+                    waitUntil: "networkidle",
+                    timeout: 30000
+                });
+            }
+            catch (error) {
+                const err = error;
+                if (err.message.includes("timeout") || err.message.includes("Timeout")) {
+                    throw new HotelSearchError("Page load timed out. The server may be slow or unavailable.", ErrorCodes.TIMEOUT, true);
+                }
+                if (err.message.includes("net::") || err.message.includes("Network")) {
+                    throw new HotelSearchError("Network error occurred. Please check your connection.", ErrorCodes.NETWORK_ERROR, true);
+                }
+                throw new HotelSearchError(`Navigation failed: ${err.message}`, ErrorCodes.NAVIGATION_FAILED, true);
+            }
+            await this.page.waitForTimeout(2000);
+            // Check for blocking/CAPTCHA before proceeding
+            await this.checkForBlocking();
+            // Check for no results / destination issues
+            await this.checkForNoResults();
+            // Close any popups/modals
+            await this.dismissPopups();
+            // Scroll to load more results
+            await this.scrollToLoadMore();
+            // Extract detailed hotel info
+            const hotels = await this.extractHotelDetails();
+            // Apply client-side filtering and scoring if we have preferences
+            if (filters) {
+                return this.scoreAndFilterHotels(hotels, filters);
+            }
+            return hotels;
+        }, DEFAULT_RETRY_CONFIG, (attempt, error, delayMs) => {
+            console.error(`Search attempt ${attempt} failed: ${error.message}. Retrying in ${Math.round(delayMs / 1000)}s...`);
+        });
     }
     async dismissPopups() {
         if (!this.page)
@@ -557,6 +729,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 +759,8 @@ export class HotelBrowser {
                     amenities,
                     highlights,
                     link,
+                    thumbnailUrl,
+                    availability,
                 });
             });
             return results;
@@ -682,6 +874,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;
             }
@@ -690,32 +885,53 @@ export class HotelBrowser {
             .sort((a, b) => (b.matchScore || 0) - (a.matchScore || 0));
     }
     async getHotelDetails(hotelUrl) {
-        if (!this.page)
-            throw new Error("Browser not initialized");
-        await this.page.goto(hotelUrl, { waitUntil: "networkidle" });
-        await this.page.waitForTimeout(2000);
-        await this.dismissPopups();
-        // Extract detailed information from hotel page
-        return await this.page.evaluate(() => {
-            const details = {};
-            // Hotel name
-            const nameEl = document.querySelector('h2[class*="pp-header"]');
-            details.name = nameEl?.textContent?.trim();
-            // Description
-            const descEl = document.querySelector('[data-testid="property-description"]');
-            details.description = descEl?.textContent?.trim();
-            // All facilities
-            const facilityEls = document.querySelectorAll('[data-testid="property-section-facilities"] li');
-            details.facilities = Array.from(facilityEls).map((el) => el.textContent?.trim());
-            // Photos
-            const photoEls = document.querySelectorAll('[data-testid="gallery-image"] img');
-            details.photos = Array.from(photoEls)
-                .slice(0, 5)
-                .map((el) => el.src);
-            // Popular facilities highlighted
-            const popularFacilities = document.querySelectorAll('[data-testid="property-most-popular-facilities"] span');
-            details.popularFacilities = Array.from(popularFacilities).map((el) => el.textContent?.trim());
-            return details;
+        if (!this.page) {
+            throw new HotelSearchError("Browser not initialized. Call init() first.", ErrorCodes.BROWSER_NOT_INITIALIZED, false);
+        }
+        return await retryWithBackoff(async () => {
+            // Enforce rate limiting
+            await this.enforceRateLimit();
+            try {
+                await this.page.goto(hotelUrl, {
+                    waitUntil: "networkidle",
+                    timeout: 30000
+                });
+            }
+            catch (error) {
+                const err = error;
+                if (err.message.includes("timeout") || err.message.includes("Timeout")) {
+                    throw new HotelSearchError("Page load timed out. The server may be slow or unavailable.", ErrorCodes.TIMEOUT, true);
+                }
+                throw new HotelSearchError(`Navigation failed: ${err.message}`, ErrorCodes.NAVIGATION_FAILED, true);
+            }
+            await this.page.waitForTimeout(2000);
+            // Check for blocking/CAPTCHA
+            await this.checkForBlocking();
+            await this.dismissPopups();
+            // Extract detailed information from hotel page
+            return await this.page.evaluate(() => {
+                const details = {};
+                // Hotel name
+                const nameEl = document.querySelector('h2[class*="pp-header"]');
+                details.name = nameEl?.textContent?.trim();
+                // Description
+                const descEl = document.querySelector('[data-testid="property-description"]');
+                details.description = descEl?.textContent?.trim();
+                // All facilities
+                const facilityEls = document.querySelectorAll('[data-testid="property-section-facilities"] li');
+                details.facilities = Array.from(facilityEls).map((el) => el.textContent?.trim());
+                // Photos
+                const photoEls = document.querySelectorAll('[data-testid="gallery-image"] img');
+                details.photos = Array.from(photoEls)
+                    .slice(0, 5)
+                    .map((el) => el.src);
+                // Popular facilities highlighted
+                const popularFacilities = document.querySelectorAll('[data-testid="property-most-popular-facilities"] span');
+                details.popularFacilities = Array.from(popularFacilities).map((el) => el.textContent?.trim());
+                return details;
+            });
+        }, DEFAULT_RETRY_CONFIG, (attempt, error, delayMs) => {
+            console.error(`Get details attempt ${attempt} failed: ${error.message}. Retrying in ${Math.round(delayMs / 1000)}s...`);
         });
     }
     async takeScreenshot(path) {

package/dist/index.js

@@ -3,7 +3,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-import { HotelBrowser } from "./browser.js";
+import { HotelBrowser, HotelSearchError, ErrorCodes } from "./browser.js";
 // Property type enum
 const PropertyTypeEnum = z.enum([
     "hotel", "apartment", "resort", "villa", "vacation_home", "hostel", "bnb",
@@ -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.2.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";
@@ -455,6 +481,38 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
     }
     catch (error) {
+        // Handle custom HotelSearchError with structured error info
+        if (error instanceof HotelSearchError) {
+            let helpText = "";
+            switch (error.code) {
+                case ErrorCodes.CAPTCHA_DETECTED:
+                    helpText = "\n\nTip: Wait 5-10 minutes before trying again.";
+                    break;
+                case ErrorCodes.RATE_LIMITED:
+                case ErrorCodes.BLOCKED:
+                    helpText = "\n\nTip: The server is rate-limiting requests. Wait a few minutes before trying again.";
+                    break;
+                case ErrorCodes.DESTINATION_NOT_FOUND:
+                    helpText = "\n\nTip: Check the destination spelling. Try a more specific location like 'Paris, France' instead of just 'Paris'.";
+                    break;
+                case ErrorCodes.TIMEOUT:
+                    helpText = "\n\nTip: The request timed out. This may be due to slow network or server issues. Try again.";
+                    break;
+                case ErrorCodes.NETWORK_ERROR:
+                    helpText = "\n\nTip: Check your internet connection and try again.";
+                    break;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error [${error.code}]: ${error.message}${helpText}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Handle generic errors
         const errorMessage = error instanceof Error ? error.message : String(error);
         return {
             content: [
@@ -486,7 +544,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.2.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.2.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"