@striderlabs/mcp-booking 0.1.0

package/README.md

@@ -0,0 +1,127 @@
+# @striderlabs/mcp-booking
+
+MCP server for Booking.com — search hotels, check availability, manage reservations, and more via AI agents.
+
+By [Strider Labs](https://striderlabs.ai)
+
+---
+
+## Overview
+
+This MCP (Model Context Protocol) server gives AI agents the ability to interact with Booking.com using browser automation (Playwright). It supports 14 tools covering the full hotel booking workflow.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `booking_status` | Check login/session status |
+| `booking_login` | Initiate login flow (returns URL for manual login) |
+| `booking_logout` | Clear saved session and cookies |
+| `booking_search` | Search hotels by destination, dates, guests, rooms |
+| `booking_get_property` | Get property details (amenities, description, policies) |
+| `booking_check_availability` | Check room availability for specific dates |
+| `booking_get_prices` | Get pricing for a property |
+| `booking_filter_results` | Filter last search by price, rating, amenities |
+| `booking_sort_results` | Sort last search by price/rating/distance/reviews |
+| `booking_save_property` | Save to wishlist/favorites |
+| `booking_book` | Book a room (requires `confirm=true`) |
+| `booking_get_reservations` | List current/upcoming reservations |
+| `booking_cancel_reservation` | Cancel a booking (requires `confirm=true`) |
+| `booking_get_reviews` | Get guest reviews for a property |
+
+## Requirements
+
+- Node.js 18+
+- A Booking.com account (for bookings, reservations, and wishlist)
+
+## Installation
+
+```bash
+npm install @striderlabs/mcp-booking
+```
+
+Or install Playwright browsers after install:
+
+```bash
+npx playwright install chromium
+```
+
+## Configuration
+
+Add to your MCP config (e.g. `~/.claude/mcp_servers.json`):
+
+```json
+{
+  "mcpServers": {
+    "booking": {
+      "command": "npx",
+      "args": ["-y", "@striderlabs/mcp-booking"]
+    }
+  }
+}
+```
+
+## Authentication
+
+The server uses cookie-based session persistence. Cookies are stored at `~/.strider/booking/`.
+
+1. Run `booking_login` to get the login URL
+2. Open the URL in your browser and sign in
+3. Run `booking_status` to verify the session is active
+
+## Usage Examples
+
+### Search hotels
+
+```
+booking_search(destination="Paris", checkIn="2026-06-01", checkOut="2026-06-05", adults=2, rooms=1)
+```
+
+### Filter and sort results
+
+```
+booking_filter_results(maxPrice=200, minRating=8.0, freeCancellation=true)
+booking_sort_results(sortBy="rating")
+```
+
+### Check availability and prices
+
+```
+booking_check_availability(propertyUrl="https://www.booking.com/hotel/fr/...", checkIn="2026-06-01", checkOut="2026-06-05")
+booking_get_prices(propertyUrl="...", checkIn="2026-06-01", checkOut="2026-06-05")
+```
+
+### Book a room
+
+```
+# Preview first (no confirm flag)
+booking_book(propertyUrl="...", checkIn="2026-06-01", checkOut="2026-06-05", adults=2)
+
+# Confirm booking (only after explicit user approval)
+booking_book(propertyUrl="...", checkIn="2026-06-01", checkOut="2026-06-05", adults=2, confirm=true)
+```
+
+### Manage reservations
+
+```
+booking_get_reservations()
+booking_cancel_reservation(reservationId="12345678", confirm=true)
+```
+
+## Safety
+
+- `booking_book` requires `confirm=true` and should only be called with explicit user confirmation
+- `booking_cancel_reservation` requires `confirm=true` and is irreversible
+- Both tools return a preview/warning when called without the confirm flag
+
+## Development
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT — Strider Labs

package/dist/auth.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Strider Labs - Booking.com Auth/Session Management
+ *
+ * Handles cookie persistence and session management for Booking.com.
+ */
+import type { BrowserContext } from "playwright";
+export interface SessionInfo {
+    isLoggedIn: boolean;
+    userEmail?: string;
+    userName?: string;
+    lastUpdated: string;
+    currency?: string;
+}
+/**
+ * Save cookies from browser context to disk
+ */
+export declare function saveCookies(context: BrowserContext): Promise<void>;
+/**
+ * Load cookies from disk and apply to browser context
+ */
+export declare function loadCookies(context: BrowserContext): Promise<boolean>;
+/**
+ * Save session info to disk
+ */
+export declare function saveSessionInfo(info: SessionInfo): void;
+/**
+ * Load session info from disk
+ */
+export declare function loadSessionInfo(): SessionInfo | null;
+/**
+ * Clear all saved auth data
+ */
+export declare function clearAuthData(): void;
+/**
+ * Check if we have saved cookies (may or may not still be valid)
+ */
+export declare function hasSavedCookies(): boolean;
+/**
+ * Get the config directory path (useful for debugging)
+ */
+export declare function getConfigDir(): string;

package/dist/auth.js

@@ -0,0 +1,96 @@
+/**
+ * Strider Labs - Booking.com Auth/Session Management
+ *
+ * Handles cookie persistence and session management for Booking.com.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const CONFIG_DIR = path.join(os.homedir(), ".strider", "booking");
+const COOKIES_FILE = path.join(CONFIG_DIR, "cookies.json");
+const SESSION_FILE = path.join(CONFIG_DIR, "session.json");
+/**
+ * Ensure config directory exists
+ */
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Save cookies from browser context to disk
+ */
+export async function saveCookies(context) {
+    ensureConfigDir();
+    const cookies = await context.cookies();
+    fs.writeFileSync(COOKIES_FILE, JSON.stringify(cookies, null, 2));
+}
+/**
+ * Load cookies from disk and apply to browser context
+ */
+export async function loadCookies(context) {
+    if (!fs.existsSync(COOKIES_FILE)) {
+        return false;
+    }
+    try {
+        const cookiesJson = fs.readFileSync(COOKIES_FILE, "utf-8");
+        const cookies = JSON.parse(cookiesJson);
+        // Filter out expired cookies
+        const now = Date.now() / 1000;
+        const validCookies = cookies.filter((c) => !c.expires || c.expires > now);
+        if (validCookies.length > 0) {
+            await context.addCookies(validCookies);
+            return true;
+        }
+    }
+    catch (error) {
+        console.error("Failed to load cookies:", error);
+    }
+    return false;
+}
+/**
+ * Save session info to disk
+ */
+export function saveSessionInfo(info) {
+    ensureConfigDir();
+    fs.writeFileSync(SESSION_FILE, JSON.stringify(info, null, 2));
+}
+/**
+ * Load session info from disk
+ */
+export function loadSessionInfo() {
+    if (!fs.existsSync(SESSION_FILE)) {
+        return null;
+    }
+    try {
+        const sessionJson = fs.readFileSync(SESSION_FILE, "utf-8");
+        return JSON.parse(sessionJson);
+    }
+    catch (error) {
+        console.error("Failed to load session info:", error);
+        return null;
+    }
+}
+/**
+ * Clear all saved auth data
+ */
+export function clearAuthData() {
+    if (fs.existsSync(COOKIES_FILE)) {
+        fs.unlinkSync(COOKIES_FILE);
+    }
+    if (fs.existsSync(SESSION_FILE)) {
+        fs.unlinkSync(SESSION_FILE);
+    }
+}
+/**
+ * Check if we have saved cookies (may or may not still be valid)
+ */
+export function hasSavedCookies() {
+    return fs.existsSync(COOKIES_FILE);
+}
+/**
+ * Get the config directory path (useful for debugging)
+ */
+export function getConfigDir() {
+    return CONFIG_DIR;
+}

package/dist/browser.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Strider Labs - Booking.com Browser Automation
+ *
+ * Playwright-based browser automation for Booking.com operations.
+ */
+import { type SessionInfo } from "./auth.js";
+export interface PropertyResult {
+    propertyId: string;
+    name: string;
+    location: string;
+    rating?: number;
+    reviewScore?: number;
+    reviewCount?: number;
+    pricePerNight?: string;
+    totalPrice?: string;
+    currency?: string;
+    imageUrl?: string;
+    url?: string;
+    distanceFromCenter?: string;
+    stars?: number;
+    freeCancellation?: boolean;
+    breakfastIncluded?: boolean;
+}
+export interface RoomOption {
+    roomId?: string;
+    name: string;
+    maxGuests?: number;
+    bedType?: string;
+    price?: string;
+    totalPrice?: string;
+    freeCancellation?: boolean;
+    breakfastIncluded?: boolean;
+    available: boolean;
+}
+export interface Reservation {
+    reservationId: string;
+    propertyName: string;
+    checkIn: string;
+    checkOut: string;
+    guests?: number;
+    totalPrice?: string;
+    status: string;
+    confirmationNumber?: string;
+}
+export interface Review {
+    reviewer?: string;
+    date?: string;
+    score?: number;
+    title?: string;
+    positives?: string;
+    negatives?: string;
+    country?: string;
+}
+/**
+ * Close browser and save state
+ */
+export declare function closeBrowser(): Promise<void>;
+/**
+ * Check Booking.com login status
+ */
+export declare function checkLoginStatus(): Promise<SessionInfo>;
+/**
+ * Initiate login flow
+ */
+export declare function initiateLogin(): Promise<{
+    loginUrl: string;
+    instructions: string;
+}>;
+/**
+ * Search hotels on Booking.com
+ */
+export declare function searchProperties(destination: string, checkIn: string, checkOut: string, adults?: number, rooms?: number, children?: number, maxResults?: number): Promise<PropertyResult[]>;
+/**
+ * Get property details by URL or property ID
+ */
+export declare function getPropertyDetails(propertyUrlOrId: string): Promise<Record<string, unknown>>;
+/**
+ * Check room availability for a property
+ */
+export declare function checkAvailability(propertyUrlOrId: string, checkIn: string, checkOut: string, adults?: number, rooms?: number): Promise<{
+    available: boolean;
+    rooms: RoomOption[];
+    message: string;
+}>;
+/**
+ * Get prices for a property
+ */
+export declare function getPrices(propertyUrlOrId: string, checkIn: string, checkOut: string, adults?: number, rooms?: number): Promise<{
+    prices: RoomOption[];
+    currency: string;
+    lowestPrice?: string;
+}>;
+/**
+ * Filter cached search results
+ */
+export declare function filterResults(filters: {
+    minPrice?: number;
+    maxPrice?: number;
+    minRating?: number;
+    freeCancellation?: boolean;
+    breakfastIncluded?: boolean;
+    stars?: number;
+    keyword?: string;
+}): PropertyResult[];
+/**
+ * Sort cached search results
+ */
+export declare function sortResults(sortBy: "price_asc" | "price_desc" | "rating" | "distance" | "reviews"): PropertyResult[];
+/**
+ * Save a property to favorites (wishlist)
+ */
+export declare function saveProperty(propertyUrlOrId: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+/**
+ * Book a room (with explicit confirmation required)
+ */
+export declare function bookRoom(propertyUrlOrId: string, checkIn: string, checkOut: string, adults?: number, rooms?: number, confirmBooking?: boolean): Promise<{
+    requiresConfirmation: true;
+    summary: Record<string, unknown>;
+} | {
+    success: boolean;
+    bookingId?: string;
+    message: string;
+}>;
+/**
+ * Get current reservations
+ */
+export declare function getReservations(): Promise<Reservation[]>;
+/**
+ * Cancel a reservation
+ */
+export declare function cancelReservation(reservationId: string, confirmCancellation?: boolean): Promise<{
+    success: boolean;
+    message: string;
+}>;
+/**
+ * Get reviews for a property
+ */
+export declare function getPropertyReviews(propertyUrlOrId: string, maxReviews?: number): Promise<{
+    reviews: Review[];
+    averageScore?: number;
+    totalReviews?: number;
+}>;