HQBeds Connector for AI agents.
10 live capabilities
Manage hostel bookings and property occupancy with a conversational PMS.
Waiting for input…
Why people use HQBeds
HQBeds PMS Integration for Faster Hostel Booking Management
With this Connector, you just tell your AI client to book a room for a guest. It calls the right capabilities, handles the data, and confirms it's done. You get a clean, conversational way to run your front desk without the manual data entry headache.
What Vinkius changes
You get a chat-based interface for your entire property management system.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Quick Check-in
A guest arrives and the receptionist uses get_guest and create_reservation to handle the stay in seconds.
- Real-world use case 02
Occupancy Audit
A manager asks for a summary of the weekend and uses list_availability to see what is left to sell.
- Real-world use case 03
Guest History
A staff member needs to know if a returning guest paid last time and uses list_reservations.
Complete set · 10capabilities
The complete HQBeds capability set.
These are the exact actions your AI can choose when you ask it to work with HQBeds.
01—04
4 capabilities in this set.
Part of 10 available through HQBeds.
- 01 Capability
Check hqbeds status
Confirm that your connection to the HQBeds platform is active. Use this to make sure your agent can reach your data.
- 02 Capability
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.
- 03 Capability
Get account
View your high level account information and settings. Use this to check your profile and general property details.
- 04 Capability
Get guest
Pull the complete profile for a specific guest. This helps you see check in history and personal details.
05—07
3 capabilities in this set.
Part of 10 available through HQBeds.
- 05 Capability
Get reservation
Fetch specific details for a single booking. Use this to see stay dates and payment status quickly.
- 06 Capability
Get room
Retrieve detailed information about a specific room in your property. This helps you see room types and current status.
- 07 Capability
List availability
Check which rooms are free for specific dates using ISO 8601 format. Use this to see what is open for upcoming bookings.
08—10
3 capabilities in this set.
Part of 10 available through HQBeds.
- 08 Capability
List guests
Get a full directory of every guest in your system. This is useful for viewing your entire customer list at once.
- 09 Capability
List reservations
Pull a complete list of all current and future bookings. Use this to get a high level view of your upcoming schedule.
- 10 Capability
List rooms
See a full inventory of all rooms available in your property. This helps you manage your total room count and types.
Set up in minutes
One URL. Then ask HQBeds to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use HQBeds from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it HQBeds, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable HQBeds for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the HQBeds URL.
- Step 03
Save and start
Save the connection and enable HQBeds in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"hqbeds": {
"url": "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using HQBeds
Open Agent mode in chat and ask: "Using HQBeds, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"hqbeds": {
"url": "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using HQBeds
Ask Copilot: "Using HQBeds, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"hqbeds": {
"url": "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using HQBeds
Open Cascade and ask: "Using HQBeds, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"hqbeds": {
"url": "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using HQBeds
Ask Cline: "Using HQBeds, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add hqbeds --transport http "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using HQBeds
Ask Claude: "Using HQBeds, show me...". 10 tools are ready
Where the request belongs
Work HQBeds can move forward.
For hospitality owners and front-desk staff who are tired of manual data entry and constantly refreshing booking calendars to stay updated.
Hostel Manager
Checking occupancy rates and booking summaries for weekly reporting.
Reception Lead
Verifying guest details and creating quick reservations during busy check-in hours.
Hospitality Developer
Pulling property data into custom internal capabilities via AI queries.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsAmenitiz
Manage hotel reservations, room types, availability, rates, and guest profiles for your Amenitiz PMS through natural conversation.
Mews
Manage hotel reservations, guests, rooms, billing, housekeeping, and services for your Mews property through natural conversation.
Beds24
Manage properties, bookings, rooms, calendar, availability, and pricing for your Beds24 channel manager through natural conversation.
Hostaway
Manage vacation rental listings, reservations, calendar, channels, guest conversations, and financials for your Hostaway properties through natural conversation.
Softinn
Orchestrate Softinn Hotel PMS. manage reservations, rooms, and guest folios directly from any AI agent.
Cloudbeds
Manage hotel reservations, guests, rooms, housekeeping, availability, and revenue dashboard for your Cloudbeds property through natural conversation.
Bring your own AI
Change the model, client or framework. Keep HQBeds connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about HQBeds.
The practical details behind the request, access and result.
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 capability to retrieve real-time availability across all rooms for any date range.
How do I create a new reservation?
Use the create_reservation capability with guest name, room ID, check-in and check-out dates. Your agent handles the rest automatically.
One connection away
Give your agent a direct line to HQBeds.
Connect HQBeds once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available