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.
- Site
- booking.com
- Functions
- 15
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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_comOne 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/mcpSet it up in your clientBoth 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.
autocompleteDestinationFind booking.com destinations (cities, districts, landmarks, hotels) for a free-text place name, with dest_id, dest_type, coordinates and a display…Arguments
Name Type Required 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/autocompleteDestinationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.autocompleteDestination({ query: "Paris" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.autocompleteDestination({"query": "Paris"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/autocompleteDestination \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Paris"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.autocompleteDestination({ query: "Paris" });checkPriceCheck a specific property's own room rate table for given dates.Arguments
Name Type Required urlstringA property page url, e.g. from search/listAvailability/getProperty.Yes checkInstringYYYY-MM-DD.Yes checkOutstringYYYY-MM-DD.Yes adultsnumberDefault 2.No roomsnumberDefault 1.No Returns
PropertyPriceCheckinterface 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/checkPriceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.checkPrice({ url: "<url>", checkIn: "<checkIn>", checkOut: "<checkOut>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.checkPrice({ "url": "<url>", "checkIn": "<checkIn>", "checkOut": "<checkOut>" }))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/checkPrice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>","checkIn":"<checkIn>","checkOut":"<checkOut>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/getAccountProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.getAccountProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.getAccountProfile())curl -X POST https://api.bowmark.ai/v1/sites/booking_com/getAccountProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.getAccountProfile();getBookingGet one of the caller's own Booking.com trips by the id listBookings returns.Arguments
Name Type Required idstringA 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/getBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.getBooking({ id: "0" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.getBooking({"id": "0"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/getBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"0"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.getBooking({ id: "0" });getPropertyFetch detailed property information including amenities, photos and reviews.Arguments
Name Type Required 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/getPropertyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.getProperty({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.getProperty({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/getProperty \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
ReviewBreakdowninterface 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/getReviewBreakdownCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.getReviewBreakdown({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.getReviewBreakdown({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/getReviewBreakdown \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.getReviewBreakdown({ url: "<url>" });listAvailabilityList available properties for a given search with availability status and pricing.Arguments
Name Type Required destinationstringYes checkInstringYYYY-MM-DD.Yes checkOutstringYYYY-MM-DD.Yes adultsnumberDefault 2.No roomsnumberDefault 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/listAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listAvailability({ destination: "Paris", checkIn: { $daysFromNow: 9 }, checkOut: { $daysFromNow: 11 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listAvailability({ "destination": "Paris", "checkIn": {"$daysFromNow": 9}, "checkOut": {"$daysFromNow": 11} }))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"destination":"Paris","checkIn":{"$daysFromNow":9},"checkOut":{"$daysFromNow":11}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ limit?: number }No Returns
BookingTripsinterface 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/listBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listBookings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listBookings())curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listBookings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listFilterOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listFilterOptions({ destination: "Paris", checkIn: { $daysFromNow: 9 }, checkOut: { $daysFromNow: 11 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listFilterOptions({ "destination": "Paris", "checkIn": {"$daysFromNow": 9}, "checkOut": {"$daysFromNow": 11} }))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listFilterOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"destination":"Paris","checkIn":{"$daysFromNow":9},"checkOut":{"$daysFromNow":11}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.listFilterOptions({ destination: "Paris", checkIn: { $daysFromNow: 9 }, checkOut: { $daysFromNow: 11 } });listPropertyPhotosList the property page's own photo gallery.Arguments
Name Type Required urlstringYes Returns
ListPropertyPhotosResultinterface 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/listPropertyPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listPropertyPhotos({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listPropertyPhotos({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listPropertyPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.listPropertyPhotos({ url: "<url>" });listPropertyReviewsList guest reviews for a property.Arguments
Name Type Required 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/listPropertyReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listPropertyReviews({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listPropertyReviews({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listPropertyReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Wishlistsinterface 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/listWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.listWishlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.listWishlist())curl -X POST https://api.bowmark.ai/v1/sites/booking_com/listWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.listWishlist();searchSearch for accommodations by destination, dates and parameters; returns property listings with availability and pricing.Arguments
Name Type Required destinationstringYes checkInstringYes checkOutstringYes adultsnumberNo childrennumberNo Returns
{ properties: SearchPropertyListing[] }interface SearchPropertyListing { id: string; // the hotel page's slug, getProperty's url ends in it name: string; url: string; // pass straight to getProperty({ url }) pricePerNight: number | null; // the card's own "Per night" figure totalPrice: number | null; // the whole stay after any discount, as the card states it (USD from prod) rating: number | null; reviewCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booking_com/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.search({ destination: "Paris", checkIn: { $daysFromNow: 9 }, checkOut: { $daysFromNow: 11 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.search({ "destination": "Paris", "checkIn": {"$daysFromNow": 9}, "checkOut": {"$daysFromNow": 11} }))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"destination":"Paris","checkIn":{"$daysFromNow":9},"checkOut":{"$daysFromNow":11}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.search({ destination: "Paris", checkIn: { $daysFromNow: 9 }, checkOut: { $daysFromNow: 11 } });
addToWishlistSave a property to one of the caller's own Booking.com saved lists.Arguments
Name Type Required args{ hotelId: string; listId?: string }Yes Returns
WishlistWriteResultinterface 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/addToWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.addToWishlist({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.addToWishlist({}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/addToWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.addToWishlist({});removeFromWishlistRemove a property from one of the caller's own Booking.com saved lists.Arguments
Name Type Required args{ hotelId: string; listId?: string }Yes Returns
WishlistWriteResultinterface 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/removeFromWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booking_com.removeFromWishlist({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booking_com.removeFromWishlist({}))curl -X POST https://api.bowmark.ai/v1/sites/booking_com/removeFromWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booking_com.removeFromWishlist({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/booking_com/<function> - OpenAPI
/v1/sites/booking_com/openapi.json