# Cloudbeds MCP for AI Agents MCP > Cloudbeds lets your AI client run an entire hotel operation through one chat window. Manage everything from bookings and guest profiles to housekeeping status and daily financial dashboards, all via natural conversation. Check room availability, track every transaction, or get a full picture of today's revenue instantly. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** property-management, hotel-reservations, booking-engine, revenue-management, guest-profiles, housekeeping ## Description Need to manage a property without jumping between five different tabs? Connect your Cloudbeds account through this MCP and run the whole hotel from one chat window. You can ask your agent for an instant rundown of today’s performance—like occupancy, total revenue, and ADR. Need to check if Room 312 is available next month? Just ask. If a front desk agent needs guest history, they can pull up everything about that person, including their past stays and spending habits. Housekeeping managers get real-time updates on cleaning status and which rooms need immediate attention. This capability lets you manage reservations, guests, rooms, transactions, and even run financial reports without ever leaving your chat client. It’s the centralized operational view every manager needs. ## Tools ### list_reservations Retrieves a list of hotel reservations, letting you filter by status like confirmed or checked out. ### get_dashboard Pulls up the main property dashboard with today's key metrics on revenue and occupancy. ### get_reservation Retrieves comprehensive details for a single, specific booking. ### search_guests Finds guest profiles and provides details on their past stays, contact information, and lifetime value. ### get_guest Retrieves a complete profile for a specific hotel guest by identifying data. ### list_rooms Lists all physical rooms in the property, giving you an overview of the current inventory. ### list_room_types Provides a breakdown of different room types available, including amenities and base pricing. ### get_housekeeping Checks the housekeeping status for all rooms to help staff prioritize cleaning tasks. ### check_availability Determines which rooms are open and available for any date range you specify. ### list_transactions Shows a guest's full financial history, allowing you to track charges and payments associated with their stay. ## Prompt Examples **Prompt:** ``` What was our revenue performance for last night? ``` **Response:** ``` 🏨 **Yesterday's Dashboard Summary — Oct 17** 💰 **Total Revenue**: $9,120.50 📊 **Occupancy Rate**: 84% (49/58 rooms) 📈 **ADR**: $186.13 ✅ **Key Movements**: 7 check-ins completed; 5 check-outs processed. 🧹 **Housekeeping Note**: Three rooms were marked 'Dirty' late, delaying final status updates. ``` **Prompt:** ``` Find the details for Mr. Chen who is checking out tomorrow. ``` **Response:** ``` **Guest Profile Found: David Chen** * **Room:** 402 (Executive Suite) * **Check-in**: Oct 15th * **Check-out**: Oct 18th * **Status**: Checked In. Balance Due: $0.00. ✅ **Notes**: Guest has a platinum status and requested feather-free pillows. ``` **Prompt:** ``` How many rooms are available for two people next weekend? ``` **Response:** ``` I checked the calendar for Friday, Nov 1st through Sunday, Nov 3rd. * **Friday (Nov 1st)**: 12 rooms available. Best type: Standard King. * **Saturday (Nov 2nd)**: 8 rooms available. Best type: Double Queen. * **Sunday (Nov 3rd)**: 15 rooms available. Mix of all types. Let me know if you want to check rates for a specific date. ``` ## Capabilities ### Check daily performance metrics Pull up the property dashboard to see today's key figures like occupancy rate, total revenue, and average room rate. ### Find and review guest profiles Search for any guest by name or contact info to view their full stay history, preferences, and lifetime value with the property. ### List current bookings Retrieve a list of reservations, filtering them by status (like confirmed, checked in, or cancelled) for quick front-desk use. ### Get room inventory details View all available rooms and the specific types offered on site, including amenity information and base rates. ### Update housekeeping status Get a report on cleaning statuses across the property to help staff prioritize which rooms need service immediately. ## Use Cases ### Guest needs immediate check-in information A front desk agent asks the AI client for 'the ongoing reservation of John Doe.' The agent runs 'get_guest' and provides John’s room number, check-in date, and any special preferences instantly. ### Manager needs to forecast revenue gaps A revenue manager asks the AI client: 'What rooms are available next month for corporate rates?' The agent runs 'check_availability' and lists open dates and room counts, helping optimize future pricing. ### Housekeeping needs to clear backlogs A supervisor asks the AI client: 'List all rooms that are currently dirty.' The agent uses 'get_housekeeping' to return a prioritized list of cleaning tasks, ensuring efficient staff deployment. ### Checking past guest spending habits The hotel owner wants to know how much Mr. Smith spent last year. They ask the AI client and it runs 'list_transactions' for that specific user, detailing all charges on file. ## Benefits - Daily operations get faster. Instead of checking separate reports, running a single query to 'get_dashboard' gives you today’s full occupancy rate, revenue, and ADR instantly. - Guest history is always ready. You can search for guests using the 'search_guests' tool to pull up their entire profile, past stays, and preferences in seconds. - Housekeeping gets organized. Use 'get_housekeeping' to get a prioritized list of dirty rooms awaiting turnover, eliminating manual walk-throughs. - Booking inquiries are simple. Running 'check_availability' lets your agent confirm open rooms for any date range without needing access to the core booking engine directly. - Financial tracking is seamless. You can use 'list_transactions' to track a guest’s charges and payments, making end-of-stay billing much easier. ## How It Works The bottom line is you get an instant, centralized view of the entire hotel operation through simple conversation. 1. Your AI client connects directly to your Cloudbeds account credentials via Vinkius. 2. The agent uses this MCP's tools to access real-time operational data about reservations, rooms, and guests. 3. It returns a natural language summary or structured data table that answers your specific question. ## Frequently Asked Questions **How can the Cloudbeds MCP help me track guest payments and charges?** This MCP lets you review a guest's complete financial history by pulling transaction records. You see every charge, payment, and balance owed, which makes reconciling accounts much faster than manual lookups. **Can I use the Cloudbeds MCP to check room status quickly?** Yes, you can get a real-time report on housekeeping statuses. It tells you exactly which rooms are 'Dirty,' 'Inspected,' or ready for sale, helping your staff prioritize cleaning efforts. **What kind of operational reports does the Cloudbeds MCP provide?** It provides a comprehensive daily dashboard that summarizes key performance indicators (KPIs) like occupancy rate, revenue generated, and Average Daily Rate. It gives you a clear picture of how the property performed. **Does the Cloudbeds MCP help with booking changes?** Absolutely. You can use it to list reservations and filter them by status—whether they're confirmed, cancelled, or checked in—giving you an immediate overview of your current bookable inventory. **Is the Cloudbeds MCP useful for revenue managers?** Yes. It helps track financial trends and room availability across different date ranges, allowing you to optimize rates and forecast future revenue with reliable data.