Connect Claude to Your Escape Room in 5 Minutes

Go from zero to AI-managed escape rooms. You need a HyperXI account and Claude Desktop installed.

1

Sign up for HyperXI

Create your account at hyperxi.com/signup. Choose a tenant slug during onboarding -- this is your unique identifier (e.g. downtown-escape).

2

Generate an API key

Go to Admin → Settings, open the API Keys tab, and click Generate New Key.

Your key will look like this:

hxi_live_a1b2c3d4e5f6g7h8i9j0...

Copy and save this key immediately. It is only shown once.

3

Configure Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the HyperXI MCP server:

claude_desktop_config.json
{
  "mcpServers": {
    "hyperxi": {
      "command": "npx",
      "args": ["-y", "hyperxi-mcp"],
      "env": {
        "HYPERXI_API_KEY": "hxi_live_your_key_here",
        "HYPERXI_TENANT_SLUG": "your-slug",
        "BACKEND_URL": "https://api.hyperxi.com:10443"
      }
    }
  }
}

Replace hxi_live_your_key_here with your actual API key and your-slug with your tenant slug.

Restart Claude Desktop after saving the file.

4

Test the connection

Open a new conversation in Claude Desktop and try:

"List my rooms"

Claude will call the list_rooms tool and return your escape rooms. You should see something like:

Claude's response
I found 3 rooms at your Downtown location:

1. The Vault -- 60 min, 2-6 players, $35/person
   Status: active, Difficulty: hard

2. Haunted Manor -- 60 min, 2-8 players, $30/person
   Status: active, Difficulty: medium

3. Space Station -- 75 min, 4-10 players, $40/person
   Status: active, Difficulty: expert

Would you like to check availability or manage
schedules for any of these rooms?
5

Start managing

Now that you are connected, try these example prompts:

Set up holiday hours for December 24-25 -- close all rooms.

Show me this week's bookings and tell me which rooms are underperforming.

Create a 20% discount code called SPRING20 valid through April 30.

How much revenue did we generate last month?

Invite sarah@myescaperoom.com as a manager.

Check if all waivers are signed for booking #abc123.

Troubleshooting

"Tool not found" or no tools appear

  • Make sure you restarted Claude Desktop after editing the config file
  • Check that npx is available on your PATH (run npx --version in your terminal)
  • Verify the JSON is valid -- a missing comma or bracket will silently fail

"Unauthorized" or "Invalid API key"

  • Double-check the HYPERXI_API_KEY value -- it must start with hxi_live_
  • Make sure the key has not been revoked in Admin → Settings → API Keys

"Tenant not found" or wrong data

  • Verify HYPERXI_TENANT_SLUG matches your tenant slug exactly (case-sensitive, hyphens included)
  • You can find your slug in Admin → Settings → General

Connection timeout

  • Make sure the BACKEND_URL is set to https://api.hyperxi.com:10443
  • Check your internet connection and firewall settings

What next?

Browse the full tool reference to see every tool available to your AI, or check the API reference if you want to build custom integrations.