How to Use the HQBeds MCP in CrewAI

Q: Where is the property account data stored during execution?

Information retrieved via getaccount exists only within the active session memory. Vinkius isolates every MCP Server connection, ensuring no cross-contamination between different hostel accounts.

Deploy autonomous CrewAI agent teams to manage reservations via the HQBeds MCP server, monitor occupancy, and handle guest communications.

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 CrewAI

Create your Vinkius account to connect HQBeds to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Deploy an Autonomous Front Desk Team

The `list_guests` tool allows a dedicated CRM agent to scan all incoming travelers for the day. This agent builds a manifest of arrivals, while a separate inventory agent cross-references the list. CrewAI's role-based execution means the CRM agent passes the manifest to the inventory agent, who then runs `list_reservations`. The team flags any overbooked rooms or unassigned beds without human intervention.

Monitor Occupancy and Pricing Gaps

Executing `list_availability` requires ISO 8601 dates, which a scheduling agent generates and formats perfectly. It queries the system for upcoming weekends to identify low occupancy periods. Once the data returns through this MCP integration, an analyst agent reviews the gaps. It can then draft promotional emails to past customers using historical data pulled from earlier sessions.

Handle Booking Modifications

Using `get_reservation` lets a support agent pull exact details when a guest requests a change. The agent reads the current state of the booking, including room assignments and dates. If the requested change requires overriding standard policies, a moderator agent steps in. It evaluates the request, checks `get_room` for alternative options, and escalates to a human manager if necessary.

Setup guide

Set up HQBeds MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HQBeds tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HQBeds Analyst",
    goal="Access and analyze HQBeds data via MCP.",
    backstory="Expert analyst with direct HQBeds access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HQBeds transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HQBeds Analyst",
        goal="Access and analyze HQBeds data via MCP.",
        backstory="Expert analyst with direct HQBeds access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HQBeds transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

Pass your Vinkius endpoint directly into the mcps array when defining your Agent. For more granular control, import MCPServerHTTP and use tool_filter to restrict access.

Assign read-only tools to specific roles. Give your research agent access to availability checks, but only allow your booking agent to create reservations.

Agents use shared memory during sequential or hierarchical execution. When one agent fetches a guest profile, the context automatically passes to the next agent in the pipeline.

You can connect using stdio, SSE, or Streamable HTTP. The framework handles the underlying communication protocol automatically.

Information retrieved via get_account exists only within the active session memory. Vinkius isolates every MCP Server connection, ensuring no cross-contamination between different hostel accounts.

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