Cloudbeds MCP server for AI agents

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

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

Connect

Just Cloudbeds

An MCP server for Cloudbeds 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/cloudbeds
Every site

One MCP server for Cloudbeds 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
  • getAvailabilityCalendarReturns, for each day in a date range, which room types and rates are open at a property, the nightly rate, rooms left, minimum and maximum stay, and…

    Arguments

    NameTypeRequired
    propertystring
    Property code or booking-page URL.
    Yes
    startDatestring
    YYYY-MM-DD.
    Yes
    endDatestring
    YYYY-MM-DD, inclusive.
    Yes
    promoCodestringNo

    Returns CloudbedsCalendarResult

    interface CloudbedsCalendarResult {
      propertyCode: string; propertyId: string;
      days: { date: string; open: { roomTypeId: string; rateId: string; packageId: string; rate: number; roomsLeft: number; minStay: number | null; maxStay: number | null; closedToArrival: boolean; closedToDeparture: boolean; closed: boolean }[] }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/getAvailabilityCalendar

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getAvailabilityCalendar({
      property: "t7OI21",
      startDate: { $daysFromNow: 30 },
      endDate: { $daysFromNow: 40 }
    });
  • getBookingQuotePrices a stay before booking it, from the rate ids searchRooms returned: nightly and total price, taxes and fees, the deposit due now, the payment…

    Arguments

    NameTypeRequired
    propertystringYes
    checkInstringYes
    checkOutstringYes
    rooms{ rateId: string; adults: number; kids?: number }[]Yes
    currencystringNo
    promoCodestringNo

    Returns CloudbedsPricedStay

    interface CloudbedsBookingQuote {
      propertyCode: string; propertyId: string; checkIn: string; checkOut: string; currency: string;
      rooms: { name: string; rateId: string; adults: number; kids: number; count: number; rateWithoutInclusiveTaxAndFees: number }[];
      taxes: number; fees: number; total: number; deposit: number; grandTotal: number;
      paymentSchedule: unknown; cancellationSchedule: unknown;
      cartToken: string | null;     // not a reservation; bookRoom takes this to confirm one
    }
    
    interface CloudbedsPricedStay extends CloudbedsBookingQuote {
      bookingUrl: string;   // the property's booking page on the quoted dates
      // The handoff: give the person checkout.url (pick the same room and rate there) and
      // stop. They book as a guest and pay themselves; Bowmark never books.
      checkout: { status: string; url: string; urlKind: 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 }; warnings: string[] } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/getBookingQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getBookingQuote({
      property: "<property>",
      checkIn: "<checkIn>",
      checkOut: "<checkOut>",
      rooms: {}
    });
  • getOrganizationReturns a hotel group that books through one Cloudbeds page (a chain, a hostel network) from its id or slug: its name and every property in it, with…

    Arguments

    NameTypeRequired
    args{ organization: string }Yes

    Returns CloudbedsOrganization

    interface CloudbedsOrganization {
      organizationId: string; name: string; slug: string | null; logo: string | null;
      properties: { propertyId: string; code: string; name: string; bookingUrl: string; currency: string | null; timeZone: string | null;
        city: string | null; state: string | null; country: string | null; lat: number | null; lng: number | null;
        website: string | null; checkInTime: string | null; checkOutTime: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/getOrganization

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getOrganization({ organization: "higroup" });
  • getPoliciesA property's cancellation, deposit and payment terms in plain language, plus its house terms, privacy text and bank-transfer instructions where it…

    Arguments

    NameTypeRequired
    args{ property: string; checkInDate?: string }Yes

    Returns CloudbedsPolicies

    interface CloudbedsPolicies {
      propertyCode: string; propertyId: string; smartPoliciesEnabled: boolean;
      smartPolicyText: string | null; cancellationPolicy: string | null; terms: string | null;
      privacyPolicy: string | null; bankTransferInstructions: string | null;
      deposit: { type: string | null; percent: number | null };
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getPolicies({ property: "t7OI21" });
  • getPropertyReturns one property from its code or booking-page URL: name, description, address and coordinates, phone, email and website, check-in and check-out…

    Arguments

    NameTypeRequired
    propertystringYes

    Returns CloudbedsProperty

    interface CloudbedsProperty {
      code: string;            // the 6-character property code every function takes
      propertyId: string;      // Cloudbeds' numeric id
      name: string;
      bookingUrl: string;
      description: string | null;
      address: { line1: string | null; line2: string | null; city: string | null; state: string | null; zip: string | null; country: string | null; lat: number | null; lng: number | null; formatted: string | null };
      phone: string | null; email: string | null; website: string | null;
      checkInTime: string | null; checkOutTime: string | null;   // "15:00"
      currency: string | null; language: string | null;
      taxesIncluded: boolean; feesIncluded: boolean;
      deposit: { type: string | null; percent: number | null };
      paymentMethods: { card: boolean; bankTransfer: boolean; paypal: boolean };
      smartPoliciesEnabled: boolean;
      amenities: string[]; photos: string[];
      cancellationPolicy: string | null; terms: string | null;  // plain text
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getProperty("t7OI21");
  • getReservationReads a reservation made through a property's Cloudbeds booking page, from the data_res token on its confirmation link: Cloudbeds' confirmation…

    Arguments

    NameTypeRequired
    args{ reservationToken: string }Yes

    Returns CloudbedsReservation

    interface CloudbedsReservation {
      reservationToken: string;
      confirmation: Record<string, unknown>;   // Cloudbeds' confirmation payload, passed through unrenamed
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getReservation({});
  • getRoomTypeOne room type's full detail at a property.

    Arguments

    NameTypeRequired
    args{ property: string; roomTypeId: string; checkIn?: string; checkOut?: string }Yes

    Returns CloudbedsRoomTypeDetail

    interface CloudbedsRoomTypeDetail {
      propertyCode: string; roomTypeId: string; name: string; description: string | null;
      maxGuests: number | null; maxAdults: number | null; maxChildren: number | null;
      beds: number | null; private: boolean; bookable: boolean;
      photo: string | null; photos: string[]; amenities: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/getRoomType

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.getRoomType({ property: "t7OI21", roomTypeId: "657556" });
  • listAddonsThe extras a property sells with a chosen room and stay (breakfast, transfers, parking, tours): name, description, price and how it is charged.

    Arguments

    NameTypeRequired
    args{ property: string; roomTypeId: string; checkIn: string; checkOut: string; adults: number; kids?: number }Yes

    Returns CloudbedsAddonsResult

    interface CloudbedsAddon {
      addonId: string; name: string; description: string | null; price: number;
      chargeType: string | null;    // "perStay" | "perNight" | "perGuest", as the site labels it
    }
    
    interface CloudbedsAddonsResult {
      propertyCode: string; propertyId: string; roomTypeId: string;
      addons: CloudbedsAddon[];   // empty means this property sells none for that room and stay
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/listAddons

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.listAddons({
      property: "t7OI21",
      roomTypeId: "657556",
      checkIn: { $daysFromNow: 45 },
      checkOut: { $daysFromNow: 47 },
      adults: 2
    });
  • searchOrganizationAvailabilityFor a hotel group and a check-in and check-out date, lists which of its properties have rooms free and each one's cheapest nightly rate and stay…

    Arguments

    NameTypeRequired
    args{ organization: string; checkIn: string; checkOut: string; currency?: string }Yes

    Returns CloudbedsOrganizationAvailability

    interface CloudbedsOrganizationAvailability {
      organizationId: string; checkIn: string; checkOut: string;
      properties: { propertyId: string; code: string | null; name: string | null; hasAvailability: boolean;
        minNightlyRate: { amount: string; currency: string } | null;   // amount exactly as Cloudbeds returns it
        minTotalPrice: { amount: string; currency: string } | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/searchOrganizationAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.searchOrganizationAvailability({
      organization: "1",
      checkIn: { $daysFromNow: 45 },
      checkOut: { $daysFromNow: 47 }
    });
  • searchRoomsLists the rooms a property has free for a check-in and check-out date and a number of guests: per room type its name, description, photos, beds, max…

    Arguments

    NameTypeRequired
    propertystring
    Property code ("t7OI21") or booking-page URL.
    Yes
    checkInstring
    YYYY-MM-DD.
    Yes
    checkOutstring
    YYYY-MM-DD.
    Yes
    currencystring
    ISO code; defaults to the property's own.
    No
    promoCodestringNo

    Returns CloudbedsSearchRoomsResult

    interface CloudbedsRoomType {
      roomTypeId: string; rateId: string; packageId: string;
      name: string; description: string | null;
      maxGuests: number | null; maxAdults: number | null; maxChildren: number | null;
      beds: number | null; private: boolean;
      roomsLeft: number;
      total: number;                                  // the whole stay
      nightlyRates: { date: string; rate: number }[];
      minStay: number | null; maxStay: number | null;
      photo: string | null; photos: string[];
    }
    
    interface CloudbedsSearchRoomsResult {
      propertyCode: string; propertyId: string; checkIn: string; checkOut: string; currency: string;
      rooms: CloudbedsRoomType[];
      unavailable: { roomTypeId: string; name: string; description: string | null; maxGuests: number | null; minStay: number | null }[];
      channelPrices: { roomName: string; direct: number | null; channels: { channel: string; price: number }[] }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/searchRooms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.searchRooms({
      property: "t7OI21",
      checkIn: { $daysFromNow: 45 },
      checkOut: { $daysFromNow: 47 }
    });
Act 1
  • bookRoomBooks rooms at a property for the caller as a guest checkout (no Cloudbeds account): the rooms and rates from searchRooms, guest names, email, phone…

    Arguments

    NameTypeRequired
    propertystringYes
    checkInstringYes
    checkOutstringYes
    rooms{ rateId: string; adults: number; kids?: number }[]Yes
    guest{ firstName: string; lastName: string; email: string; phone: string; country: string; address?: string; city?: string; state?: string; zip?: string }Yes
    arrivalTimestringNo
    promoCodestringNo
    currencystringNo
    confirmboolean
    The caller's explicit go-ahead; without it nothing is reserved.
    No

    Returns CloudbedsBooking

    interface CloudbedsBookingQuote {
      propertyCode: string; propertyId: string; checkIn: string; checkOut: string; currency: string;
      rooms: { name: string; rateId: string; adults: number; kids: number; count: number; rateWithoutInclusiveTaxAndFees: number }[];
      taxes: number; fees: number; total: number; deposit: number; grandTotal: number;
      paymentSchedule: unknown; cancellationSchedule: unknown;
      cartToken: string | null;     // not a reservation; bookRoom takes this to confirm one
    }
    
    interface CloudbedsBooking {
      status: "payment_required" | "awaiting_confirmation" | "reserved";
      propertyCode: string; bookingUrl: string;
      amountDueNow: number;          // the deposit Cloudbeds asks up front, in quote.currency
      quote: CloudbedsBookingQuote;
      reservationToken: string | null;   // "reserved" only; getReservation reads it
      message: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cloudbeds/bookRoom

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cloudbeds.bookRoom({
      property: "<property>",
      checkIn: "<checkIn>",
      checkOut: "<checkOut>",
      rooms: {},
      guest: {}
    });

Use it from code