Cloudbeds MCP. Run your entire hotel operation from a single chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Cloudbeds connects your entire property management system to any AI client. Use natural conversation to manage reservations, check room availability, view guest profiles, and track daily revenue KPIs.
It runs your hotel operations—from front desk tasks to housekeeping scheduling—all through one single conversation with your agent.
What your AI agents can do
Check availability
Checks open rooms for a given date range to support booking inquiries.
Get dashboard
Retrieves key operational metrics like occupancy, revenue, and ADR for the property.
Get guest
Fetches a specific guest's profile details.
Runs check_availability to instantly verify open rooms for specific dates and ranges.
Calls get_dashboard to retrieve today's key performance indicators, including occupancy and revenue.
Uses search_guests to fetch a guest's full profile, contact info, and stay history.
Triggers get_housekeeping to pull the current cleaning status and priorities for all rooms.
Invokes get_reservation to retrieve all specific details for a single booking ID.
Uses list_reservations to pull a list of bookings, allowing filtering by status like 'confirmed' or 'checked_in'.
Calls list_transactions to provide a complete financial history for a specific reservation.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d7573check availability
Checks open rooms for a given date range to support booking inquiries.
019d7573get dashboard
Retrieves key operational metrics like occupancy, revenue, and ADR for the property.
019d7573get guest
Fetches a specific guest's profile details.
019d7573get housekeeping
Gets the current status of rooms and housekeeping needs.
019d7573get reservation
Retrieves all details for a single, specific reservation.
019d7573list reservations
Lists multiple reservations and allows filtering by status (e.g., confirmed, cancelled).
019d7573list room types
Lists available room types, including amenities, base rates, and maximum occupancy.
019d7573list rooms
Lists all physical hotel rooms currently in the system.
019d7573list transactions
Lists a guest's complete financial history across all reservations.
019d7573search guests
Searches for and returns a guest's full profile, past stays, and contact information.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Cloudbeds, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Connect your whole property management system to any AI client. Use natural talk to manage everything—reservations, room status, guest info, revenue tracking. Your agent runs your hotel operations, from the front desk to housekeeping scheduling, all through one conversation.
Checking Availability
When you need to know if you got open rooms for certain dates, your agent runs check_availability to instantly verify open rooms for specific date ranges. You can also see all available room types, including amenities, base rates, and max occupancy, by calling list_room_types. To get a list of every physical room in the system, use list_rooms.
Viewing Performance Metrics
Your agent pulls today's key numbers with get_dashboard, giving you metrics like occupancy, revenue, and ADR.
Managing Guest Data
To find a guest's full profile, including contact info and stay history, your agent uses search_guests. If you know the guest's name, you can fetch specific details with get_guest. You can also track a guest's whole financial history across all stays by running list_transactions.
Handling Bookings
To see every detail for a single booking ID, your agent invokes get_reservation. You can pull a list of multiple reservations and filter them by status—like 'confirmed' or 'checked_in'—using list_reservations. For reservations, you can also view all bookings using list_reservations.
Tracking Housekeeping and Finances
To get the current cleaning status and priorities for all rooms, your agent triggers get_housekeeping. To track a specific guest's charges and payments, you run list_transactions.
How Cloudbeds MCP Works
- 1 Your AI client sends a natural language query (e.g., 'What's our revenue for last night?').
- 2 The Cloudbeds MCP Server intercepts the query, determines the intent, and executes the necessary tool (e.g.,
get_dashboard). - 3 The server returns the structured data (JSON) to your AI client, which then formats it into a human-readable answer.
The bottom line is your AI client handles the complex data calls, and you just talk to it.
Who Is Cloudbeds MCP For?
Hotel owners and managers who need a single source of truth for operations. This is for the front desk agent who is tired of switching between three different tabs just to check a guest's status. It's for the revenue manager who needs to know ADR trends without writing a single SQL query.
Quickly look up a guest's profile using search_guests, verify room availability with check_availability, and pull up booking details using get_reservation.
Run get_dashboard to track today's occupancy and revenue, and use list_transactions to analyze rate trends across different booking types.
Ask a single question like, 'How did we do yesterday?' to get a full operational briefing using get_dashboard.
Check room cleaning statuses and prioritize tasks by calling get_housekeeping.
What Changes When You Connect
- See immediate room availability by using
check_availability—you don't have to navigate date pickers and room maps. Just ask your agent, and it gives you the open room count. - Stop calculating KPIs manually.
get_dashboardgives you today's occupancy, revenue, and ADR in one shot, perfect for a quick morning briefing. - Never lose a guest's history again.
search_guestspulls up their full profile, past stays, and preferences instantly, no matter how many times they stayed with you. - Streamline housekeeping.
get_housekeepinggives you a prioritized list of dirty rooms and status updates, so staff know exactly where to start. - Track financials without logging into accounting.
list_transactionsgives a full record of payments and charges tied to a guest's reservation. - Manage multiple bookings easily.
list_reservationslets you filter all current bookings by status (e.g., 'checked_in') without clicking through pages of data.
Real-World Use Cases
A front desk agent needs to handle a walk-in booking.
A guest asks, 'Do you have any rooms available next weekend?' The agent's AI client runs check_availability for the date range. The agent gets a list of open rooms, confirms the best type using list_room_types, and books it, all without leaving the chat.
The GM needs a quick end-of-day report.
The GM asks, 'What was our revenue and occupancy yesterday?' The agent runs get_dashboard. It gets the KPI data (revenue, ADR, occupancy) and presents it immediately, letting the GM know the day's performance in seconds.
A guest calls with a billing question.
The agent asks the guest's name, and the AI client runs search_guests. It pulls the profile, then runs list_transactions to show the guest the exact charges and payment history, solving the billing issue immediately.
Housekeeping needs to know which rooms to prioritize.
Instead of checking a physical board, the supervisor asks, 'What rooms need cleaning?' The agent runs get_housekeeping. It returns a prioritized list of rooms that are 'dirty' and ready for turnover.
The Tradeoffs
Trying to list every room and then filter.
Calling list_rooms to get every room ID, and then trying to loop through them manually to find the status of a specific room type.
→
Use get_housekeeping or list_rooms with specific parameters. If you need all room types, start with list_room_types. This saves time and avoids unnecessary data transfer.
Finding a guest's history by guessing the ID.
The agent tries to pull guest data by just knowing the name, and the system returns nothing because the name isn't unique or the ID is wrong.
→
Always start by using search_guests. This tool searches by name, contact, and past stays, guaranteeing you find the right person before attempting to get their profile or transactions.
Checking availability for a single date only.
Asking, 'Is Room 305 free tomorrow?' when the booking is actually for a whole week. The agent might only check the single day, missing future conflicts.
→
Always use check_availability and specify a proper date range. This ensures the agent checks the entire block of time, giving you a reliable booking picture.
When It Fits, When It Doesn't
Use this if your core need is reading, checking, or listing operational data. It's your central source of truth for all things hotel management—bookings, guests, and rooms. Don't use it if you need to write data (e.g., confirming a booking or changing a rate). For that, you'll need a separate system integration. If you only need room types, use list_room_types; if you need to check a single room's status, use get_housekeeping. Always start with the specific tool, then ask the agent to combine the results.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cloudbeds. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Running a hotel requires jumping between five different screens.
Right now, to check a guest's booking history, you open the main PMS dashboard. Then, you click the 'Guests' tab. Next, you search for the name. After finding them, you open their profile, and finally, you click the 'Billing' tab to see transactions. It takes four clicks and three tabs.
With the Cloudbeds MCP Server, you just tell your agent, 'Show me Mr. Smith's billing history.' The agent runs `search_guests` and `list_transactions` in the background and delivers the full report instantly. It's one conversation, zero clicks.
Cloudbeds MCP Server: Manage reservations, guests & revenue
The old way meant that getting a full operational picture required running multiple reports (Occupancy Report, Housekeeping Status, Revenue Summary) and manually cross-referencing the dates and counts. It was slow, and the data was often out of sync.
Now, your agent runs `get_dashboard` and `get_housekeeping` simultaneously. It delivers a combined, current snapshot—occupancy, revenue, and room status—in a single, reliable response. The data is always together.
Common Questions About Cloudbeds MCP
How do I check if a room is available using the check_availability tool? +
You ask your agent, 'Check availability for dates X to Y.' The tool verifies open rooms for that entire range. It's better than just checking a single date.
Can I see a guest's full financial history using the list_transactions tool? +
Yes, the list_transactions tool pulls a complete financial history. You must provide the specific reservation ID or guest ID for the tool to work.
What is the difference between get_guest and search_guests? +
search_guests finds a person using general info (name, email, etc.). get_guest requires a specific ID to pull up the complete, detailed profile.
How do I find out the room status for housekeeping? +
Use the get_housekeeping tool. It gives you a real-time list of which rooms are dirty, inspected, or ready for turnover.
What information does the `list_room_types` tool provide, and how does it help with pricing? +
The list_room_types tool provides details like max occupancy, amenities, base rate, and room count. You use this to confirm what room types are available and what their base rates are before calculating final pricing.
If I need to find a specific reservation, should I use `list_reservations` or `get_reservation`? +
Use get_reservation when you have the specific ID for a single booking. Use list_reservations if you need to view a filtered list of bookings, such as all confirmed or cancelled reservations.
Does the `search_guests` tool give me enough detail to know a guest's stay history? +
Yes, search_guests returns not only the profile and contact info but also past stays and the guest's calculated lifetime value. This helps revenue managers assess a guest's long-term worth.
How do I get an overview of the day's performance using `get_dashboard`? +
get_dashboard provides a high-level summary of today's KPIs, including occupancy, revenue, and Average Daily Rate (ADR). It's the best tool for a quick morning business review.
How many properties use Cloudbeds? +
Cloudbeds serves 20,000+ properties in 150+ countries — hotels, hostels, vacation rentals, B&Bs, and hotel groups. It's the most widely used all-in-one hospitality platform.
Can I use the AI to manage the cleaning schedule? +
Yes! The MCP communicates directly with the Cloudbeds Housekeeping module. You can query dirty rooms, assign staff, and update statuses like 'Inspected' conversationally.
Is the dashboard data delayed? +
No, it pulls strictly real-time numbers natively routed from the Cloudbeds API covering exact metrics on ADR, current Occupancy, and live Check-in progress.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Amplifier
E-commerce fulfillment orchestration — manage orders, inventory, and shipments via AI.
UnionPay Open Platform
Bring UnionPay QR Codes and secure global payments to your AI workflow. Handle card verification and online checkout.
Gameball Alternative
Automate loyalty programs and gamification via Gameball — manage customer profiles, track points, and handle order rewards directly from any AI agent.
You might also like
Synthesia
Produce professional AI videos with lifelike avatars that present in 140+ languages without cameras, studios, or actors.
Neon (Serverless PostgreSQL)
Manage serverless database infrastructure via Neon — spawn zero-copy branches, audit projects, and monitor compute endpoints.
IBM watsonx
Connect IBM watsonx to any AI agent via MCP.