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.
- Site
- cloudbeds.com
- Functions
- 11
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/cloudbedsOne MCP server for Cloudbeds 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
Open a function to see its arguments, what it returns and how to call it.
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
Name Type Required propertystringProperty code or booking-page URL.Yes startDatestringYYYY-MM-DD.Yes endDatestringYYYY-MM-DD, inclusive.Yes promoCodestringNo Returns
CloudbedsCalendarResultinterface 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/getAvailabilityCalendarCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getAvailabilityCalendar({ property: "t7OI21", startDate: { $daysFromNow: 30 }, endDate: { $daysFromNow: 40 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getAvailabilityCalendar({ "property": "t7OI21", "startDate": {"$daysFromNow": 30}, "endDate": {"$daysFromNow": 40} }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getAvailabilityCalendar \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"t7OI21","startDate":{"$daysFromNow":30},"endDate":{"$daysFromNow":40}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required propertystringYes checkInstringYes checkOutstringYes rooms{ rateId: string; adults: number; kids?: number }[]Yes currencystringNo promoCodestringNo Returns
CloudbedsPricedStayinterface 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/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getBookingQuote({ property: "<property>", checkIn: "<checkIn>", checkOut: "<checkOut>", rooms: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getBookingQuote({ "property": "<property>", "checkIn": "<checkIn>", "checkOut": "<checkOut>", "rooms": {} }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"<property>","checkIn":"<checkIn>","checkOut":"<checkOut>","rooms":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ organization: string }Yes Returns
CloudbedsOrganizationinterface 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/getOrganizationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getOrganization({ organization: "higroup" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getOrganization({"organization": "higroup"}))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getOrganization \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"organization":"higroup"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ property: string; checkInDate?: string }Yes Returns
CloudbedsPoliciesinterface 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/getPoliciesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getPolicies({ property: "t7OI21" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getPolicies({"property": "t7OI21"}))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getPolicies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"t7OI21"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required propertystringYes Returns
CloudbedsPropertyinterface 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/getPropertyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getProperty("t7OI21");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getProperty("t7OI21"))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getProperty \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"property":"t7OI21"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ reservationToken: string }Yes Returns
CloudbedsReservationinterface CloudbedsReservation { reservationToken: string; confirmation: Record<string, unknown>; // Cloudbeds' confirmation payload, passed through unrenamed }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cloudbeds/getReservationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getReservation({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getReservation({}))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getReservation \ -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.cloudbeds.getReservation({});getRoomTypeOne room type's full detail at a property.Arguments
Name Type Required args{ property: string; roomTypeId: string; checkIn?: string; checkOut?: string }Yes Returns
CloudbedsRoomTypeDetailinterface 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/getRoomTypeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.getRoomType({ property: "t7OI21", roomTypeId: "657556" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.getRoomType({"property": "t7OI21", "roomTypeId": "657556"}))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/getRoomType \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"t7OI21","roomTypeId":"657556"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ property: string; roomTypeId: string; checkIn: string; checkOut: string; adults: number; kids?: number }Yes Returns
CloudbedsAddonsResultinterface 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/listAddonsCall 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 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.listAddons({ "property": "t7OI21", "roomTypeId": "657556", "checkIn": {"$daysFromNow": 45}, "checkOut": {"$daysFromNow": 47}, "adults": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/listAddons \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"t7OI21","roomTypeId":"657556","checkIn":{"$daysFromNow":45},"checkOut":{"$daysFromNow":47},"adults":2}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ organization: string; checkIn: string; checkOut: string; currency?: string }Yes Returns
CloudbedsOrganizationAvailabilityinterface 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/searchOrganizationAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.searchOrganizationAvailability({ organization: "1", checkIn: { $daysFromNow: 45 }, checkOut: { $daysFromNow: 47 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.searchOrganizationAvailability({ "organization": "1", "checkIn": {"$daysFromNow": 45}, "checkOut": {"$daysFromNow": 47} }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/searchOrganizationAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"organization":"1","checkIn":{"$daysFromNow":45},"checkOut":{"$daysFromNow":47}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required propertystringProperty code ("t7OI21") or booking-page URL.Yes checkInstringYYYY-MM-DD.Yes checkOutstringYYYY-MM-DD.Yes currencystringISO code; defaults to the property's own.No promoCodestringNo Returns
CloudbedsSearchRoomsResultinterface 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/searchRoomsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.searchRooms({ property: "t7OI21", checkIn: { $daysFromNow: 45 }, checkOut: { $daysFromNow: 47 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.searchRooms({ "property": "t7OI21", "checkIn": {"$daysFromNow": 45}, "checkOut": {"$daysFromNow": 47} }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/searchRooms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"t7OI21","checkIn":{"$daysFromNow":45},"checkOut":{"$daysFromNow":47}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cloudbeds.searchRooms({ property: "t7OI21", checkIn: { $daysFromNow: 45 }, checkOut: { $daysFromNow: 47 } });
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
Name Type Required 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 confirmbooleanThe caller's explicit go-ahead; without it nothing is reserved.No Returns
CloudbedsBookinginterface 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/bookRoomCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cloudbeds.bookRoom({ property: "<property>", checkIn: "<checkIn>", checkOut: "<checkOut>", rooms: {}, guest: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cloudbeds.bookRoom({ "property": "<property>", "checkIn": "<checkIn>", "checkOut": "<checkOut>", "rooms": {}, "guest": {} }))curl -X POST https://api.bowmark.ai/v1/sites/cloudbeds/bookRoom \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"property":"<property>","checkIn":"<checkIn>","checkOut":"<checkOut>","rooms":{},"guest":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cloudbeds.bookRoom({ property: "<property>", checkIn: "<checkIn>", checkOut: "<checkOut>", rooms: {}, guest: {} });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/cloudbeds/<function> - OpenAPI
/v1/sites/cloudbeds/openapi.json