HQBeds MCP for AI. Manage bookings, guests, and rooms with conversation.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
HQBeds gives you total control over hostel and hotel operations through your AI client. Manage reservations, check room availability, track guest profiles, and update occupancy status all in one chat interface.
Stop juggling dashboards; get full PMS power instantly.
What your AI can do
Check hqbeds status
Tests whether the API connection to HQBeds is working correctly.
Create reservation
Makes a new booking for a guest in a specific room.
Get account
Retrieves general account information from HQBeds.
Verify the API connection to HQBeds or pull up details for a specific account.
List all available rooms and check current availability based on dates you provide.
View, retrieve details for, or create entirely new guest reservations.
Pull up complete profiles and check-in histories for specific guests or list all registered users.
Ask an AI about this
Waiting for input…
HQBeds: 10 Tools for PMS Management
These tools let you programmatically check room status, pull guest profiles, list all bookings, and execute new reservations directly through natural language commands.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using HQBeds on VinkiusCheck Hqbeds Status
Tests whether the API connection to HQBeds is working correctly.
Create Reservation
Makes a new booking for a guest in a specific room.
Get Account
Retrieves general account information from HQBeds.
Get Guest
Pulls up the full profile and history for a single guest.
Get Reservation
Gets detailed information about one specific reservation.
Get Room
Retrieves all the technical details for a particular room unit.
List Availability
Checks which rooms are free between two specific dates you provide.
List Guests
Shows a list of all guests recorded in the system.
List Reservations
Retrieves a summary list of all current and past bookings.
List Rooms
Lists every room available in the property, regardless of its status.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 HQBeds, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HQBeds. 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 connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The chaos of managing bookings across spreadsheets and email chains.
Today, when a guest calls with a last-minute change or you need to verify inventory for a large group booking, you're probably jumping between your PMS dashboard, Excel sheets, and communication logs. You copy room IDs here, check prices there, and manually update status in another tab. It takes forever, and the chance of mixing up dates or forgetting to confirm payment is always high.
With this MCP, that process disappears into a simple conversation with your agent. Instead of clicking through five different tabs, you just ask: 'Can I book 12 rooms next month?' The system handles the complex checks (inventory, availability) and gets back an answer—and even creates the booking if you say go.
Creating new reservations with `create_reservation`
The biggest time sink is that gap between confirming a deal and getting it into the system. You find availability, talk to your team about pricing, get approval, and then you have to manually input all those details—guest name, room ID, dates, payment method—into the booking form.
Now, once you confirm the deal verbally with your agent, running `create_reservation` handles every single field. It writes the record instantly and confirms it's done. Your focus shifts from data entry to client service.
What your AI can actually do with this
You connect this MCP to any of your preferred AI clients and treat it like a dedicated property management architect. Instead of logging into multiple systems, you simply ask your agent what you need done—whether that's checking if Room 205 is free next week or pulling up the payment history for John Smith.
It handles everything from listing every current reservation to creating new bookings with just conversation. This capability makes it a central piece in any large Vinkius-powered catalog, letting your AI client manage real-world logistics and guest communications without you ever leaving your workspace.
019dd106-0924-71ba-8c93-29674cc52bb9 Here's how it actually works
The bottom line is you talk to your agent like a front-desk coordinator, and it executes the necessary booking steps across HQBeds for you.
First, subscribe to this MCP in Vinkius.
Next, grab your API Token from your HQBeds dashboard under Settings > Integrations.
Finally, connect it within your AI client (like Claude or Cursor) and start asking questions about bookings or availability.
Who is this actually for?
This MCP is built for hospitality professionals who spend too much time manually cross-referencing spreadsheets or jumping between multiple operational dashboards. If your job involves keeping track of daily occupancy, managing guest check-ins, or making last-minute room changes, you need this.
You use it to get instant summaries of current bookings and monitor overall property occupancy rates using natural language prompts.
You verify individual guest metadata, check payment statuses, or look up a room's availability without leaving your primary workflow environment.
You integrate high-speed booking and inventory data into custom apps by querying the MCP with simple AI instructions.
What Changes When You Connect
Instant Occupancy Reporting: Instead of manually compiling check-in/check-out lists, you can ask your agent to list all reservations checking in today using list_reservations. This gives immediate operational oversight.
Fast Guest Lookup: Need a guest's history? Use get_guest to pull up complete profiles and payment data instantly. You don't need to navigate multiple internal CRM tabs.
Zero Downtime Booking: When a group needs last-minute rooms, you can check availability with list_availability and immediately follow up by creating the booking using create_reservation, all in one prompt sequence.
Room Intelligence: Use get_room to understand specific room attributes (like bedding or size) before suggesting it during a new reservation. This makes your recommendations accurate every time.
System Health Check: Before relying on this MCP for mission-critical tasks, run check_hqbeds_status. This confirms the connection is live and ready, saving you from unexpected failures.
Inventory Mapping: Need to know what rooms exist? Run list_rooms first. Then, use that list in combination with get_room to build a precise internal map of your whole property.
See it in action
Handling a Group Block Booking
A sales rep asks: 'I need 10 rooms for the corporate retreat next month.' Your agent runs list_availability for those dates, shows which room types are available, and then you use that data to suggest specific rooms and run create_reservation for each one.
Checking a Client's Account Status
A developer needs to know if the booking system is connected. They ask: 'What's the status?' The agent runs check_hqbeds_status, confirming API connectivity immediately, which saves hours of troubleshooting.
Investigating a Missing Guest Profile
The front desk lead knows a guest stayed but can't find them. They ask the agent to check list_guests. If found, they use get_guest to pull up the full profile and payment details for verification.
Managing Day-to-Day Operations
The manager needs a report on today's activity. They prompt: 'Show me all check-ins.' The agent runs list_reservations, providing an instant, accurate rundown of arrivals and departures.
The honest tradeoffs
Trying to book without checking dates.
The user tries to run create_reservation immediately without knowing if the room is free. The booking fails, forcing the user to guess or re-run complex checks manually.
Always check availability first. Start by calling list_availability with ISO 8601 dates; then, use that confirmed data to run create_reservation. This prevents wasted calls and keeps your process clean.
Listing rooms vs. Checking inventory.
The user runs list_rooms (which gives all room IDs) but doesn't know if those rooms are actually available right now, leading to false positives in reports.
Don't just list the rooms; check their status. Run list_availability first to confirm which units have open dates before making any operational decisions.
Over-relying on one single tool call
A user asks for 'everything about this reservation' and only runs get_reservation. They miss crucial guest details or room specifics.
Use a sequence. Call get_reservation first, then use the ID to run get_guest (for payment history) and get_room (for specific amenities).
When It Fits, When It Doesn't
You should use this MCP if your core job is real-time operational coordination—booking, inventory management, or guest support. It's perfect for the 'daily grind' of a hotel front desk. Don't use it if you need deep financial accounting (like payroll) or complex marketing analytics that require data outside of confirmed bookings. For pure reporting and historical data analysis (e.g., calculating yearly occupancy trends), you might be better off using an external BI tool connected to your database, rather than relying on the live transactional tools like list_reservations.
However, if your goal is simply to view a static list of rooms or guests without changing any data, then running list_rooms or list_guests is fine. But if you need to verify that the whole system is ready to go, start by checking check_hqbeds_status. This MCP handles actions; other tools handle analysis.
Questions you might have
How do I check room availability using the list_availability tool? +
You must provide date ranges in ISO 8601 format (YYYY-MM-DD). The agent uses this data to confirm exactly which rooms are free for your specified dates.
Can I use get_guest to see past payment records? +
Yes, get_guest pulls up the complete profile. This includes check-in history and details about previous payments made by that guest.
What's the difference between list_reservations and get_reservation? +
list_reservations gives you a summary of many bookings (a roster). Use get_reservation when you know the specific ID and need all the detailed information for just that one booking.
Do I have to use get_account before creating a reservation? +
No. While running get_account confirms your credentials, it isn't required for daily operations like making a booking using create_reservation.
What should I do if my connection fails when calling check_hqbeds_status? +
The first step is always verifying your API credentials. If check_hqbeds_status reports an error, it means the token isn't recognized or has expired. Double-check that you retrieved the correct token from your HQBeds dashboard.
How do I get a full list of all available rooms using list_rooms? +
list_rooms returns the complete directory of every room type and ID. After listing them, use get_room on a specific ID if you need details like amenities or capacity for that single unit.
If I want to check multiple guest records, should I use list_guests? +
Yes, list_guests provides the directory of all current guests. You can then pick a specific name from that list and run get_guest to see their full profile details.
What happens if my attempt to create_reservation fails? +
If the reservation fails, your agent will return an explicit error message explaining the issue. Common failures include trying to book a room that's already occupied or using invalid check-in dates.
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.
We've already built the connector for HQBeds. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.