SiteMinder Book Direct MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on SiteMinder Book Direct: 12 typed functions through one MCP server. No SiteMinder Book Direct API key needed.

Functions
12
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just SiteMinder Book Direct

An MCP server for SiteMinder Book Direct 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/direct_book
Every site

One MCP server for SiteMinder Book Direct 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

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

Read 10
  • checkAvailabilityChecks which room types a hotel has free for a check-in and check-out date and party size (adults, children, infants), with the lowest total price…

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code from findProperty().channelCode, or its booking link / own website.
    Yes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD, after checkIn.
    Yes
    adultsnumberYes
    childrennumber
    Default 0.
    No
    infantsnumber
    Default 0.
    No
    currencyTostring
    ISO 4217, e.g. "USD". Omit for the hotel's own currency.
    No
    promocodestringNo

    Returns DirectBookAvailability

    interface DirectBookRoomPrice {
      amount: number;
      /** The site's own formatted figure, e.g. "133.20" or, with currencyTo, "$ 93.59". */
      amountStr: string;
      /** Before any promo/flash discount; equal to amount when none applies. */
      originalAmount: number | null;
    }
    
    interface DirectBookAvailableRoomType {
      /** Matches a roomType returned by listRoomTypes. */
      roomTypeId: string;
      price: DirectBookRoomPrice;
    }
    
    interface DirectBookAvailability {
      channelCode: string;
      propertyId: number;
      checkIn: string;
      checkOut: string;
      adults: number;
      children: number;
      infants: number;
      /** The currency amountStr is formatted in, when currencyTo was passed; null means the hotel's own currency. */
      currency: string | null;
      roomTypes: DirectBookAvailableRoomType[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.checkAvailability({
      property: "hotelwembleydirect",
      checkIn: "2026-12-10",
      checkOut: "2026-12-12",
      adults: 2
    });
  • checkPromoCodeChecks whether a promo code is valid at a hotel for given dates and returns what it offers.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code, booking link or own website (as findProperty takes).
    Yes
    promocodestringYes
    checkInstring
    YYYY-MM-DD; pass both dates to learn whether the code covers this stay.
    No
    checkOutstringNo

    Returns DirectBookPromoCheck

    interface DirectBookPromoCheck {
      channelCode: string;
      promocode: string;
      /** False when the hotel runs no promotion under this code. */
      valid: boolean;
      headline: string | null;
      description: string | null;
      applicableFrom: string | null;
      applicableTo: string | null;
      /** Whether it covers the checkIn/checkOut passed; null when no dates were passed or the code is invalid. */
      appliesToStay: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/checkPromoCode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.checkPromoCode({ property: "<property>", promocode: "<promocode>" });
  • findPropertyFinds a SiteMinder Book Direct hotel from what a caller has: its booking link (direct-book.com/properties/<channelCode>, or the legacy…

    Arguments

    NameTypeRequired
    propertystring
    A booking link (direct-book.com/properties/<code>, or a legacy thebookingbutton.com / .co.uk link), a bare channel code ("hotelwembleydirect"), or the hotel's own website, which links its booking engine.
    Yes

    Returns DirectBookPropertyRef

    interface DirectBookPropertyRef {
      /** Pass as `property` to every other direct_book function. */
      channelCode: string;
      /** SiteMinder's numeric property id (availability and rates take it). */
      propertyId: number;
      name: string;
      clientName: string | null;
      /** The hotel's own website. */
      website: string | null;
      bookingUrl: string;
      /** The stay length and party size the hotel's widget defaults to. */
      defaultNights: number | null;
      defaultGuests: number | null;
      /** The hotel page the booking link was read off, when `property` was the hotel's own website. */
      foundOn: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/findProperty

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.findProperty({ property: "<property>" });
  • getPoliciesReturns a hotel's booking policies: cancellation, check-in and check-out, child and pet rules, payment and deposit terms, and the taxes it adds.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code from findProperty().channelCode, or its direct-book.com/properties/<code> link.
    Yes

    Returns DirectBookPolicies

    interface DirectBookPolicy {
      /** The policy's kind as the hotel files it, e.g. "termsAndConditions". */
      type: string;
      /** The hotel-authored policy, HTML stripped to plain text. */
      text: string;
      rules: { type: string | null; key: string | null; args: unknown }[];
    }
    
    interface DirectBookTax {
      id: string;
      name: string;
      fixedAmountType: string | null;
    }
    
    interface DirectBookPolicies {
      channelCode: string;
      propertyId: number | null;
      name: string;
      /** Cancellation, deposit, check-in, child and pet terms, as the hotel wrote them. */
      policies: DirectBookPolicy[];
      /** The taxes the hotel adds to a stay. Often empty. */
      taxes: DirectBookTax[];
      /** The hotel's own policies page on direct-book.com. */
      policiesUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/getPolicies

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.getPolicies({ property: "hotelwembleydirect" });
  • getPropertyReturns one hotel's profile: name, description, star rating, address and map link, phone and email, amenities, parking and banner images.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code from findProperty().channelCode, or its direct-book.com/properties/<code> link.
    Yes

    Returns DirectBookProperty

    interface DirectBookImage {
      url: string;
      thumbnail: string | null;
      description: string | null;
    }
    
    interface DirectBookProperty {
      channelCode: string;
      propertyId: number;
      name: string;
      /** Plain text; the hotel writes it as HTML. */
      description: string;
      website: string | null;
      starRating: number | null;
      address: {
        line1: string | null;
        line2: string | null;
        city: string | null;
        state: string | null;
        postcode: string | null;
        country: string | null;
        /** ISO 3166-1 alpha-2, e.g. "GB". */
        countryCode: string | null;
        latitude: number | null;
        longitude: number | null;
        mapUrl: string | null;
        /** The hotel's own getting-here text. */
        directions: string;
      };
      phone: string[];
      email: string | null;
      amenities: string[];
      parking: string[];
      images: DirectBookImage[];
      bookingUrl: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.getProperty({ property: "hotelwembleydirect" });
  • getReservationReads a guest's existing booking from its reservation code.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code, booking link or own website.
    Yes
    reservationCodestring
    The reservation code from the guest's confirmation email.
    Yes

    Returns DirectBookReservation

    interface DirectBookReservation {
      channelCode: string;
      reservationCode: string;
      bookingReferenceId: string | null;
      active: boolean | null;
      cancelled: boolean | null;
      /** Whether the hotel lets the guest cancel this booking themselves. */
      allowGuestCancellation: boolean | null;
      guest: { title: string | null; firstName: string | null; lastName: string | null; email: string | null };
      bookingDate: string | null;
      checkIn: string | null;
      checkOut: string | null;
      arrivalTime: string | null;
      currency: string | null;
      grandTotal: number | null;
      subtotal: number | null;
      taxTotal: number | null;
      discountTotal: number | null;
      depositTotal: number | null;
      outstandingBalance: number | null;
      promocode: string | null;
      rooms: {
        roomRateId: string | null;
        roomTypeName: string | null;
        roomRateName: string | null;
        adults: number | null;
        children: number | null;
        infants: number | null;
        total: number | null;
      }[];
      extras: { name: string; total: number | null }[];
      taxes: { name: string; total: number | null }[];
      policies: { roomRateId: string | null; type: string; content: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/getReservation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.getReservation({
      property: "<property>",
      reservationCode: "<reservationCode>"
    });
  • getRoomRatesReturns every rate plan for one room type on given dates.

    Arguments

    NameTypeRequired
    argsGetRoomRatesArgsYes
    interface CheckAvailabilityArgs {
      /** The hotel's channel code from findProperty().channelCode, or its booking link / own website. */
      property: string;
      /** YYYY-MM-DD. */
      checkIn: string;
      /** YYYY-MM-DD, after checkIn. */
      checkOut: string;
      adults: number;
      /** Default 0. */
      children?: number;
      /** Default 0. */
      infants?: number;
      /** ISO 4217, e.g. "USD". Omit for the hotel's own currency. */
      currencyTo?: string;
      promocode?: string;
    }
    
    interface GetRoomRatesArgs extends CheckAvailabilityArgs {
      /** The room type whose rate plans to price, roomTypeId from listRoomTypes or checkAvailability. */
      roomTypeId: string;
    }

    Returns DirectBookRoomRates

    interface DirectBookRoomRate {
      /** What a booking takes to choose this rate. */
      roomRateId: string;
      roomTypeId: string;
      name: string;
      /** Plain text; the hotel usually puts the refund terms and what is included here. */
      description: string;
      ratePlanId: string | null;
      promotional: boolean;
      packageDeal: boolean;
      minStay: number | null;
      maxRooms: number | null;
      /** As the hotel flagged them, a description saying "free breakfast" can sit beside breakfast: false. */
      meals: { breakfast: boolean; lunch: boolean; dinner: boolean };
      /** The site still quotes a party larger than this, so check it yourself. */
      occupancy: {
        included: number | null;
        maxOccupants: number | null;
        maxAdults: number | null;
        maxChildren: number | null;
        maxInfants: number | null;
      };
      /** e.g. { type: "rateCancellationPolicy", content: "… no charge if cancelled 24 hours before arrival" }. */
      policies: { type: string; content: string | null }[];
      /** Rooms left on this rate for the dates; 0 means sold out. */
      available: number;
      promotionApplies: boolean;
      /** Total for the stay, in currencyTo when passed. */
      price: { amount: number; amountStr: string; originalAmount: number | null; taxStr: string | null };
      nightly: { date: string; amount: number; amountStr: string }[];
    }
    
    interface DirectBookRoomRates {
      channelCode: string;
      propertyId: number;
      roomTypeId: string;
      roomTypeName: string;
      checkIn: string;
      checkOut: string;
      adults: number;
      children: number;
      infants: number;
      currency: string | null;
      rates: DirectBookRoomRate[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/getRoomRates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.getRoomRates({
      property: "hotelwembleydirect",
      roomTypeId: "34326",
      checkIn: "2026-12-10",
      checkOut: "2026-12-12",
      adults: 1
    });
  • initiateBookingStarts a booking for chosen dates, room and rate: validates the cart with the hotel and returns the price breakdown and the checkout link the guest…

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code, booking link or own website.
    Yes
    roomRateIdstring
    From getRoomRates().rates[].roomRateId for the same dates.
    Yes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD, after checkIn.
    Yes
    adultsnumberYes
    childrennumberNo
    infantsnumberNo
    currencyTostring
    ISO currency to price in, e.g. "USD".
    No
    promocodestringNo

    Returns DirectBookBookingStart

    interface DirectBookBookingStart {
      channelCode: string;
      roomRateId: string;
      checkIn: string;
      checkOut: string;
      /** SiteMinder's server-side cart id. */
      cartId: string | null;
      total: number | null;
      serviceCharges: number | null;
      depositTotal: number | null;
      depositEnabled: boolean | null;
      currency: string | null;
      items: { cartItemId: string; roomRateId: string; adults: number | null; nights: number | null; amount: number | null; originalAmount: number | null; dates: string[] }[];
      /** The hotel's refusals of the cart (e.g. a minimum stay). */
      errors: { key: string; args: unknown }[];
      /** Where the guest enters their details and pays. Nothing has been booked. */
      checkoutUrl: string;
      // The handoff: give the person checkout.url (it carries the dates, party and rate)
      // and stop; they book and pay themselves. status "unavailable" means the hotel
      // refused the cart, with its reason in detail. Bowmark never books.
      checkout: { status: string; url: string; urlKind?: string; reason?: string; detail?: string; account: { site: string; hint: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null }[]; total: string | null; currency: string; dates?: { start: string; end?: string }; guests?: number } | null; warnings: string[] } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/initiateBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.initiateBooking({
      property: "<property>",
      roomRateId: "<roomRateId>",
      checkIn: "<checkIn>",
      checkOut: "<checkOut>",
      adults: 1
    });
  • listExtrasLists the add-ons a hotel sells with a stay.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code, booking link or own website (as findProperty takes).
    Yes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD, after checkIn.
    Yes
    currencystring
    3-letter code; without it the site picks a currency from the caller's location.
    No

    Returns DirectBookExtras

    interface DirectBookExtraPrice {
      amount: number | null;
      /** Formatted with its currency, e.g. "EUR 20.00". */
      amountStr: string | null;
    }
    
    interface DirectBookExtra {
      extraId: string;
      name: string;
      description: string | null;
      /** How it is charged, e.g. "Per Person Per Night", "Per Room Per Night". */
      category: string | null;
      mandatory: boolean;
      /** Whether more than one can be added. */
      multiple: boolean;
      /** The roomRateIds (getRoomRates) this extra can be added to. */
      roomRateIds: string[];
      adultPrice: DirectBookExtraPrice | null;
      childPrice: DirectBookExtraPrice | null;
      images: string[];
    }
    
    interface DirectBookExtras {
      channelCode: string;
      checkIn: string;
      checkOut: string;
      /** Empty when the hotel sells no extras. */
      extras: DirectBookExtra[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/listExtras

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.listExtras({
      property: "parkhoteldirect",
      checkIn: { $daysFromNow: 30 },
      checkOut: { $daysFromNow: 32 }
    });
  • listRoomTypesLists a hotel's room types with their ids, names, category (room or suite), beds, size, view, amenities and photos, optionally only those bookable…

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code from findProperty().channelCode, or its booking link.
    Yes
    checkInstring
    YYYY-MM-DD. With checkOut, lists only room types bookable for those dates.
    No
    checkOutstring
    YYYY-MM-DD, after checkIn.
    No

    Returns DirectBookRoomTypeList

    interface DirectBookImage {
      url: string;
      thumbnail: string | null;
      description: string | null;
    }
    
    interface DirectBookRoomType {
      roomTypeId: string;
      name: string;
      /** "room" or "suite". */
      category: string | null;
      description: string;
      smoking: boolean | null;
      view: string | null;
      bathrooms: number | null;
      /** One entry per bed, e.g. "Double bed". */
      beds: string[];
      sizeSqm: number | null;
      maxOccupancy: number | null;
      amenities: string[];
      images: DirectBookImage[];
      /** The rate plans sold on this room type; roomRateId is what rate and booking functions take. */
      rates: { roomRateId: string; name: string; ratePlanId: string | null }[];
    }
    
    interface DirectBookRoomTypeList {
      channelCode: string;
      roomTypes: DirectBookRoomType[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/listRoomTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.listRoomTypes({ property: "hotelwembleydirect" });
Act 2
  • cancelReservationCancels a guest's booking by its reservation code from the confirmation email.

    Arguments

    NameTypeRequired
    reservationCodestring
    The reservation code from the guest's confirmation email.
    Yes

    Returns DirectBookCancelledReservation

    interface DirectBookCancelledReservation {
      reservationCode: string;
      bookingReferenceId: string | null;
      active: boolean | null;
      cancelled: boolean | null;
      /** Whether the hotel lets the guest cancel this booking themselves. */
      allowGuestCancellation: boolean | null;
      grandTotal: number | null;
      outstandingBalance: number | null;
      /** The hotel's own refusals of the cancellation (e.g. past a non-refundable cutoff). */
      errors: { key: string; args: unknown }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/cancelReservation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.cancelReservation({ reservationCode: "<reservationCode>" });
  • sendEnquirySends a question to a hotel through its booking page's contact form.

    Arguments

    NameTypeRequired
    propertystring
    The hotel's channel code, booking link or own website.
    Yes
    namestringYes
    emailstringYes
    messagestringYes
    phonestringNo

    Returns DirectBookEnquiryResult

    interface DirectBookEnquiryResult {
      channelCode: string;
    
      status: string;
      message: string | null;
      /** True only once a non-FAILED status has actually been observed; false today. */
      sent: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/direct_book/sendEnquiry

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.direct_book.sendEnquiry({
      property: "<property>",
      name: "<name>",
      email: "<email>",
      message: "<message>"
    });

Use it from code