How to Use the HQBeds MCP in Cline

Build custom property dashboards and manage HQBeds reservations directly from Cline inside VS Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HQBeds MCP to Cline

Create your Vinkius account to connect HQBeds to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HQBeds with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build live property dashboards with Cline

Tell Cline to build a custom React dashboard using `list_rooms` and `list_reservations` to pull live hostel data. It hooks into the HQBeds MCP Server to fetch active listings and current occupancy directly into your codebase. Cline writes the components, plugs in the data, and runs local tests. You get a working interface that displays live guest profiles from `list_guests` without manually writing API integration boilerplate.

Automate booking verification in VS Code with Cline

Use Cline to write scripts that audit your booking channel by running `list_availability` to check open dates. The agent compares your live inventory against your local database files to spot discrepancies. If Cline finds a mismatch, it pulls the reservation details using `get_reservation` and updates the file. It handles the entire verification cycle, saving you from manual database queries.

Manage guest records directly in your Cline workspace

Cline handles your guest registry directly in your workspace using `get_guest` to pull customer histories. Ask the agent to find a customer, and it calls the tool to pull their contact info and email. If you need to update their stay, Cline uses `create_reservation` to schedule their next visit. It displays the modified files and git diffs in your VS Code sidebar, keeping you in control of every change.

Setup guide

Set up HQBeds MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type hqbeds-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest HQBeds refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "hqbeds-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HQBeds now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HQBeds MCP in Cline

Click the MCP Servers icon in your Cline sidebar. Go to the Marketplace tab for a one-click install, or use the Remote Servers tab to add the Vinkius URL. You can also edit your cline_mcp_settings.json file directly.

Yes. You can instruct Cline to write a Python or Node script that calls `list_rooms` and `list_availability` to generate custom occupancy reports. Cline will write the code, install dependencies, and run it.

No. Vinkius manages the authentication for you. Once you connect the MCP Server to Cline using your single Vinkius endpoint token, the agent can immediately run tools like `get_account` without manual setup.

Yes. If you provide Cline with a CSV of bookings, it will parse the file and call `create_reservation` for each entry. It will show you a progress log and confirm when all bookings are successfully registered.

All reservation details and room statuses remain secure because Vinkius runs the server in an isolated sandbox. Cline only reads the data needed to execute your specific workspace commands.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript