Booking.com MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Booking.com: 15 typed functions through one MCP server. No Booking.com API key needed.

Functions
15
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Booking.com

An MCP server for Booking.com alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/booking_com
Every site

One MCP server for Booking.com and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 13
  • autocompleteDestinationFind booking.com destinations (cities, districts, landmarks, hotels) for a free-text place name, with dest_id, dest_type, coordinates and a display…

    Arguments

    NameTypeRequired
    querystringYes
    limitnumberNo

    Returns { destinations: BookingDestination[] }

    interface BookingDestination {
      destId: string;
      destType: string;   // the site's own enum, uppercase: "CITY" | "DISTRICT" | "AIRPORT" | …
      name: string;
      label: string;
      region: string;
      countryCode: string;
      latitude: number | null;
      longitude: number | null;
      hotelCount: number | null;  // always null, the site's autocomplete no longer publishes this
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/autocompleteDestination

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.autocompleteDestination({ query: "Paris" });
  • checkPriceCheck a specific property's own room rate table for given dates.

    Arguments

    NameTypeRequired
    urlstring
    A property page url, e.g. from search/listAvailability/getProperty.
    Yes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD.
    Yes
    adultsnumber
    Default 2.
    No
    roomsnumber
    Default 1.
    No

    Returns PropertyPriceCheck

    interface RoomRate {
      roomType: string;             // the site's own room name, e.g. "Superior Double or Twin Room"
      pricePerNight: number | null;
      totalPrice: number | null;
      roomsLeft: number | null;           // "We have 3 left"; null when the site states no scarcity
      cancellationPolicy: "free_cancellation" | "non_refundable" | null;
      cancellationDetail: string | null;  // e.g. "before November 12, 2026"; null for non_refundable or when absent
      breakfastIncluded: boolean;
    }
    
    interface PropertyPriceCheck {
      id: string;
      url: string;
      checkIn: string;
      checkOut: string;
      rates: RoomRate[];  // every rate the property's own room table shows for these dates; [] when sold out
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/checkPrice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.checkPrice({
      url: "<url>",
      checkIn: "<checkIn>",
      checkOut: "<checkOut>"
    });
  • getAccountProfileGet the caller's account profile information.

    Arguments

    None.

    Returns { profile: AccountProfile }

    interface AccountProfile {
      displayName: string | null;   // the name in the site's own header
      firstName: string | null;
      lastName: string | null;
      initials: string | null;
      geniusLevel: number | null;   // Genius loyalty level, null when none
      geniusLabel: string | null;   // e.g. "Genius Level 2"
      avatarUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/getAccountProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.getAccountProfile();
  • getBookingGet one of the caller's own Booking.com trips by the id listBookings returns.

    Arguments

    NameTypeRequired
    idstring
    A trip id from listBookings.
    Yes

    Returns { trip: BookingTrip }

    interface BookingTrip {
      id: string;
      title: string | null;
      status: string | null;   // the site's own TripStatus word, verbatim, the site's own labels, read the values off a result, never guess one from prose
      cancelled: boolean;
      upcoming: boolean;
      startDate: string | null;
      endDate: string | null;
      createdAt: string | null;
      imageUrl: string | null;
      itemCount: number | null; // bookings (stays, flights, cars…) in the trip
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/getBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.getBooking({ id: "0" });
  • getPropertyFetch detailed property information including amenities, photos and reviews.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns { property: PropertyDetails }

    interface PropertyDetails {
      id: string;
      name: string;
      url: string;
      description: string;
      rating: number | null;
      reviewCount: number | null;
      amenities: string[];  // the site's own labels, read the values off a result, never guess one from prose
      pricePerNight: number | null;
      address: string;
      checkInTime: string | null;
      checkOutTime: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/getProperty

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.getProperty({ url: "<url>" });
  • getReviewBreakdownGet the property page's own overall review score and its category breakdown (location, cleanliness, value for money, facilities, comfort, staff…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns ReviewBreakdown

    interface ReviewScoreCategory {
      category: string;  // the site's own label, e.g. "Location", "Value for money"
      score: number;      // the site's 0-10 scale
    }
    
    interface ReviewBreakdown {
      overallScore: number | null;
      scoreLabel: string | null;   // the site's own band, e.g. "Excellent"
      reviewCount: number | null;
      categories: ReviewScoreCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/getReviewBreakdown

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.getReviewBreakdown({ url: "<url>" });
  • listAvailabilityList available properties for a given search with availability status and pricing.

    Arguments

    NameTypeRequired
    destinationstringYes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD.
    Yes
    adultsnumber
    Default 2.
    No
    roomsnumber
    Default 1.
    No

    Returns { totalAvailable: number | null; properties: AvailableUnit[] }

    interface AvailableUnit {
      id: string;
      name: string;
      url: string;                 // pass straight to getProperty({ url })
      unitName: string | null;     // the room the price is for, as the site names it
      roomsLeft: number | null;    // "We have 3 left at this price"; null when not stated
      freeCancellation: boolean;
      pricePerNight: number | null;
      totalPrice: number | null;
      originalTotalPrice: number | null;  // the struck-through figure when the card shows a deal
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listAvailability({
      destination: "Paris",
      checkIn: { $daysFromNow: 9 },
      checkOut: { $daysFromNow: 11 }
    });
  • listBookingsList the caller's own Booking.com trips ("My trips").

    Arguments

    NameTypeRequired
    args{ limit?: number }No

    Returns BookingTrips

    interface BookingTrip {
      id: string;
      title: string | null;
      status: string | null;   // the site's own TripStatus word, verbatim, the site's own labels, read the values off a result, never guess one from prose
      cancelled: boolean;
      upcoming: boolean;
      startDate: string | null;
      endDate: string | null;
      createdAt: string | null;
      imageUrl: string | null;
      itemCount: number | null; // bookings (stays, flights, cars…) in the trip
    }
    
    interface BookingTrips {
      trips: BookingTrip[];     // newest first; [] when the caller has none
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listBookings();
  • listFilterOptionsList the checkbox filter options (property rating, facilities, review score, meal plan, …) a search's own sidebar offers, with how many properties…

    Arguments

    NameTypeRequired
    destinationstringYes
    checkInstringYes
    checkOutstringYes
    adultsnumberNo
    childrennumberNo

    Returns { filters: FilterOption[] }

    interface FilterOption {
      group: string;        // the site's own group key, e.g. "class", "hotelfacility", "review_score"
      groupLabel: string;   // e.g. "Property rating"
      value: string;        // the raw filter value, e.g. "class=1"
      label: string;        // e.g. "1 star"
      count: number | null; // how many properties this filter currently narrows to
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listFilterOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listFilterOptions({
      destination: "Paris",
      checkIn: { $daysFromNow: 9 },
      checkOut: { $daysFromNow: 11 }
    });
  • listPropertyPhotosList the property page's own photo gallery.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns ListPropertyPhotosResult

    interface PropertyPhoto {
      url: string;
      caption: string | null;
    }
    
    interface ListPropertyPhotosResult {
      photos: PropertyPhoto[];
      totalCount: number | null;  // the site's own gallery size, read off its "+N photos" overlay
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listPropertyPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listPropertyPhotos({ url: "<url>" });
  • listPropertyReviewsList guest reviews for a property.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns { reviews: PropertyReview[] }

    interface PropertyReview {
      author: string;
      authorCountry: string | null;      // the flag's alt text, e.g. "United States"
      roomName: string | null;           // the room the reviewer stayed in, as the site names it
      nights: number | null;
      stayDate: string | null;           // e.g. "July 2025", the site's own month/year granularity
      travelerType: string | null;       // e.g. "Family", "Couple", "Solo traveler"
      reviewDate: string | null;         // e.g. "July 20, 2025"
      title: string | null;
      score: number | null;              // the site's 0-10 scale
      positiveText: string | null;
      negativeText: string | null;       // null when the guest left none, never ""
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listPropertyReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listPropertyReviews({ url: "<url>" });
  • listWishlistList the caller's own Booking.com saved lists and the properties in each.

    Arguments

    None.

    Returns Wishlists

    interface WishlistProperty {
      hotelId: string;
      name: string | null;
      checkin: string | null;    // dates the caller attached to the save, if any
      checkout: string | null;
    }
    
    interface Wishlist {
      listId: string;
      name: string | null;
      propertyCount: number | null;   // the site's own count
      properties: WishlistProperty[];
    }
    
    interface Wishlists {
      wishlists: Wishlist[];   // [] when the caller has saved nothing
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/listWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.listWishlist();
Act 2
  • addToWishlistSave a property to one of the caller's own Booking.com saved lists.

    Arguments

    NameTypeRequired
    args{ hotelId: string; listId?: string }Yes

    Returns WishlistWriteResult

    interface WishlistWriteResult {
      hotelId: string;
      listId: string;   // the list that was changed
      saved: boolean;   // true after addToWishlist, false after removeFromWishlist
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/addToWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.addToWishlist({});
  • removeFromWishlistRemove a property from one of the caller's own Booking.com saved lists.

    Arguments

    NameTypeRequired
    args{ hotelId: string; listId?: string }Yes

    Returns WishlistWriteResult

    interface WishlistWriteResult {
      hotelId: string;
      listId: string;   // the list that was changed
      saved: boolean;   // true after addToWishlist, false after removeFromWishlist
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/booking_com/removeFromWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.booking_com.removeFromWishlist({});

Use it from code