• DATA
  • HISTORY
  • CONTEXT
  • HUMAN

How to lookup guest history with your AI

Connect HQBeds to your AI client once. From then on, you can pull up guest profiles and stay details just by asking.

Ask AI about this page

Short answer

How can I find guest history using my AI?

You can ask your AI to find specific guests or look up details for a particular reservation. It pulls this data directly from HQBeds so you can see exactly what a guest has done in the past. Here is how the data flows.

The outcomes

What you get from your AI

The AI handles the data retrieval so you can focus on the guest.

DATA

Instant guest profiles

Your AI pulls full profiles including contact info and preferences. You get the details you need without digging through a dashboard.

HISTORY

Past stay details

The AI looks up previous bookings and stay patterns. This helps you recognize regulars and their specific needs.

CONTEXT

Reservation specifics

Get the exact details of a current or past booking. You'll see dates, room types, and other vital stay info.

HUMAN

Personalized service

The AI provides the facts, but you decide how to use them. You use the gathered info to talk to the guest personally.

The workflow

What your AI does when you ask for guest info.

The AI translates your questions into specific data requests.

  1. Find the guest

    The AI searches your database to find the right person by name or contact info.

    list_guests

  2. Pull the profile

    Once the guest is identified, the AI grabs their full profile and history.

    get_guest

  3. Check specific stays

    If you need details on a particular booking, the AI pulls that specific record.

    get_reservation

  4. Deliver the facts

    The AI presents the guest's history and preferences in a clear, readable format.

    get_guest

Try it

Copy these to start.

Use these prompts to begin interacting with your guest data.

Starting points

Swap out the names and dates in these prompts to get specific results.

HQBeds Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — HQBeds capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "hqbeds-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aCh0gy3yrr7Upi0pIrTZ2RqlAYnKLei3ANjwxJPD/mcp"
    }
  }
}
Copy into chat04

  • Find the guest profile for John Smith.

  • List all guests who stayed with us last month.

  • What are the details for reservation #5542?

  • Show me the stay history for the guest associated with email jane.doe@email.com.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect HQBeds once, then ask.

Just follow the link to connect your account. Your credentials stay encrypted and secure, and you can start chatting with your data immediately.

Connect HQBeds to your AI

FAQ

How this task behaves

  • 01

    Can the AI change guest information?

    No. The AI can only read and retrieve information from HQBeds. You must make any changes manually in your system.

  • 02

    Can I delete a reservation through the AI?

    No. This MCP is for looking up and retrieving data. It does not have the capability to delete or modify any records.

  • 03

    Does the AI see all my guest data?

    The AI only accesses the specific data it needs to answer your prompt using the available tools.

  • 04

    How do I find a guest if I don't have their ID?

    You can ask the AI to list guests or search by name, which triggers the search tools.

  • 05

    Can the AI book a new room for a guest?

    No. The current tools only allow for retrieving guest profiles and reservation details.

  • More questions about HQBeds? The Connector page answers them. See everything the HQBeds Connector can do

Connect HQBeds to Claude, Cursor, ChatGPT & more