Vinkius
HQBeds

HQBeds MCP for AI. Manage bookings, guests, and rooms with conversation.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

HQBeds MCP on Cursor AI Code EditorHQBeds MCP on Claude Desktop AppHQBeds MCP on OpenAI Agents SDKHQBeds MCP on Visual Studio CodeHQBeds MCP on GitHub Copilot AI AgentHQBeds MCP on Google Gemini AIHQBeds MCP on Lovable AI DevelopmentHQBeds MCP on Mistral AI AgentsHQBeds MCP on Amazon AWS Bedrock

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.

+ 7 more capabilities included
Check Property Status

Verify the API connection to HQBeds or pull up details for a specific account.

Manage Room Inventory

List all available rooms and check current availability based on dates you provide.

Handle Reservations

View, retrieve details for, or create entirely new guest reservations.

Track Guest Data

Pull up complete profiles and check-in histories for specific guests or list all registered users.

Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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.

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.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The HQBeds integration is available immediately — no restart needed.

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
Start building

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
HQBeds MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius HQBeds MCP - Manage Hotel & Hostel Bookings
Server ID 019dd106-0924-71ba-8c93-29674cc52bb9
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.

Built & Managed by Vinkius 30s setup 10 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.