# HQBeds MCP for AI Agents AI Agent Connect > HQBeds lets you manage your hostel or hotel operations through an AI agent. It handles everything from booking reservations and tracking room availability to managing guest profiles and checking your property's occupancy status in real time. ## Overview - **Category:** erp-operations - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/ai-agent-connect - **Tags:** reservation-management, hostel-management, occupancy-tracking, channel-distribution, guest-communication, pms ## Description Managing a property usually means having dozens of tabs open, constantly switching between your booking calendar, guest lists, and room status. You're hunting for a specific reservation or trying to see if a suite is free for next Tuesday while someone is waiting at the front desk. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of digging through a dashboard, you just ask your agent to pull up today's check-ins or see who's staying in the dorms this weekend. It handles the tedious stuff like fetching guest history, verifying payments, and checking room inventory so you can focus on the actual guests. It's a huge jump in efficiency, especially when you're trying to scale a property without adding more headcount. By connecting this to the Vinkius catalog, you get a dedicated way to keep your property management system organized and accessible through natural conversation. You get a clear picture of your occupancy and a way to handle bookings without the manual data entry headache. You can check who is arriving, what they booked, and where they are staying without ever clicking a button. It turns your property management system into a proactive partner that knows your data as well as you do. This means less time spent on admin and more time spent making sure your guests have a great stay. ## Tools ### check_hqbeds_status Confirm that your connection to the HQBeds platform is active. Use this to make sure your agent can reach your data. ### create_reservation Book a new stay for a guest directly through the AI. This allows you to add a new booking without leaving your chat. ### get_account View your high level account information and settings. Use this to check your profile and general property details. ### get_guest Pull the complete profile for a specific guest. This helps you see check in history and personal details. ### get_reservation Fetch specific details for a single booking. Use this to see stay dates and payment status quickly. ### get_room Retrieve detailed information about a specific room in your property. This helps you see room types and current status. ### list_availability Check which rooms are free for specific dates using ISO 8601 format. Use this to see what is open for upcoming bookings. ### list_guests Get a full directory of every guest in your system. This is useful for viewing your entire customer list at once. ### list_reservations Pull a complete list of all current and future bookings. Use this to get a high level view of your upcoming schedule. ### list_rooms See a full inventory of all rooms available in your property. This helps you manage your total room count and types. ## Prompt Examples **Prompt:** ``` Who is checking in today? ``` **Response:** ``` You have 5 arrivals today. The first is John Smith in Room 101 (2 nights, paid). Would you like to see guest details or payment status for any of them? ``` **Prompt:** ``` Is there anything free for this weekend? ``` **Response:** ``` This weekend you have 85% occupancy. 3 rooms are still available: Room 205 (double), Room 308 (single), and Room 412 (suite). Would you like to create a reservation? ``` **Prompt:** ``` Book a stay for Maria Silva in Room 205 from May 10 to May 12. ``` **Response:** ``` Done! Reservation created for Maria Silva in Room 205, May 10-12 (2 nights). Confirmation ID: RSV-4821. Would you like to send a confirmation email to the guest? ``` ## Capabilities ### Check room availability See which rooms are open for specific dates instantly. ### Create new bookings Add a guest reservation to your system through a simple chat command. ### Pull guest profiles Retrieve full history and personal details for any customer. ### Track occupancy Monitor how many beds or rooms are filled in real time. ### Verify API health Ensure your connection to the property system is active and working. ## Use Cases ### Quick Check-in A guest arrives and the receptionist uses get_guest and create_reservation to handle the stay in seconds. ### Occupancy Audit A manager asks for a summary of the weekend and uses list_availability to see what is left to sell. ### Guest History A staff member needs to know if a returning guest paid last time and uses list_reservations. ### Inventory Management A developer uses list_rooms to sync the property's room types with a custom website. ## Benefits - Get instant updates on room availability using list_availability without opening your browser. - Speed up check-ins by creating bookings with create_reservation through simple voice or text commands. - Pull guest histories with get_guest to provide better service during arrivals. - Monitor your entire property's status with list_reservations to spot trends and gaps. - Verify your system is always online with check_hqbeds_status to prevent booking errors. ## How It Works The bottom line is you get a chat-based interface for your entire property management system. 1. Subscribe to the HQBeds MCP on Vinkius. 2. Get your API token from the HQBeds dashboard under Settings. 3. Connect your AI client to start managing your property via chat. ## Frequently Asked Questions **How does HQBeds help with hostel management?** It connects your property management system to your AI client, allowing you to manage bookings, check-ins, and room status through natural conversation. **Can I use HQBeds to check room availability?** Yes, your AI agent can check which rooms are free for specific dates instantly, helping you manage your inventory more efficiently. **Can my AI agent create new bookings?** Yes, you can tell your agent to create a new reservation for a guest, and it will add the booking directly to your HQBeds account. **Is HQBeds good for tracking occupancy?** Yes, it provides real-time updates on how many rooms or beds are filled, so you can monitor your property's status at a glance. **How do I connect HQBeds to my AI client?** You just need to subscribe to the Connector and grab your API token from the HQBeds dashboard under the integrations settings. **Can I see guest profiles with HQBeds?** Yes, your agent can pull up complete guest profiles, including check-in history and other relevant details, to help you provide better service. **How do I find my HQBeds API key?** Log in to your HQBeds dashboard, navigate to **Settings > Integrations**, and copy your API key from the credentials section. **Can my AI agent check room availability?** Absolutely. Use the `list_availability` tool to retrieve real-time availability across all rooms for any date range. **How do I create a new reservation?** Use the `create_reservation` tool with guest name, room ID, check-in and check-out dates. Your agent handles the rest automatically.