Yourbookings,inanyAIassistant.

Connect StayHawk to Claude, ChatGPT, or your IDE and ask about deadlines, prices, and what needs attention — in plain language.

ClaudeChatGPTGeminiCursorVS Code
Read-only · Kinde-authenticated

What is this?

StayHawk runs a Model Context Protocol server. It gives an AI assistant read-only access to your booking portfolio, authenticated with the same login you use on the web app. It never writes and holds no data of its own.

Who is this for? Travellers and travel agents who want to connect an AI assistant to their own bookings — to ask what's due, what dropped in price, and what needs attention now.

Connect in three steps.

1

Add the server

In your AI client's MCP settings, add a new server pointing at the StayHawk endpoint. Most clients ask for a URL and a client ID.

2

Sign in once

Your client opens a browser window. Log in with the same StayHawk account you use on the web. The client keeps the token for you — nothing to copy or paste.

3

Ask about your trips

Ask your assistant what's due, which bookings dropped in price, or what needs attention. It reads your portfolio live and answers in plain language.

Example client config

{
  "mcpServers": {
    "stayhawk": {
      "url": "https://mcp.stayhawk.app/mcp",
      "client_id": "974dd144220a443590152e70213e835d"
    }
  }
}

The client ID is a public identifier, not a secret. Your client discovers the login and token URLs automatically from https://auth.stayhawk.app.

Connection details

MCP endpointPOST https://mcp.stayhawk.app/mcp
TransportStreamable HTTP
Client ID974dd144220a443590152e70213e835d
Authorization serverhttps://auth.stayhawk.app
Audiencehttps://api.stayhawk.app
AccessRead-only

Connect your client

Same endpoint everywhere. Point your client at the URL and sign in through the browser once — the token then renews itself. To use a static token instead, add an Authorization: Bearer <token> header to any config below.

Claude Code

Add the server, then run /mcp to sign in:

claude mcp add --transport http stayhawk https://mcp.stayhawk.app/mcp

Claude Desktop

Settings → Connectors → Add custom connector, paste the URL, then sign in:

https://mcp.stayhawk.app/mcp
Prefer the config file?
{
  "mcpServers": {
    "stayhawk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.stayhawk.app/mcp"]
    }
  }
}

mcp-remote bridges the browser login for the config-file setup. Restart Claude Desktop after editing.

ChatGPT

Enable Developer mode (Settings → Apps & Connectors → Advanced), then Settings → Connectors → Add custom connector, paste the URL and sign in:

https://mcp.stayhawk.app/mcp

Needs a paid ChatGPT plan. Turn the connector on per chat with +→ Developer mode.

Cursor

Create ~/.cursor/mcp.json (global) or .cursor/mcp.json (this project):

{
  "mcpServers": {
    "stayhawk": {
      "url": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Settings → MCP shows a green dot; first use opens the browser to sign in.

VS Code (Copilot / Agent mode)

Add to .vscode/mcp.json:

{
  "servers": {
    "stayhawk": {
      "type": "http",
      "url": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json (uses httpUrl for Streamable HTTP):

{
  "mcpServers": {
    "stayhawk": {
      "httpUrl": "https://mcp.stayhawk.app/mcp"
    }
  }
}

Gemini CLI discovers the OAuth login automatically; sign in on first use.

What your assistant can do

list_workspaces

Workspaces you belong to

get_dashboard_summary

Portfolio snapshot for a workspace

get_upcoming_bookings

Upcoming trips and their deadlines

get_action_items

What needs attention now

list_bookings

Bookings in a workspace

get_booking

One booking in full

search_bookings

Find bookings by free text

get_price_checks

Price-check history for a booking

list_alerts

Deadline and price-drop alerts

Troubleshooting

401 Unauthorized

The token is missing, expired, or minted for the wrong audience. Sign in again from your client. If you pasted a token by hand, get a fresh one.

404 / Cannot GET

Wrong path or method. MCP is a POST to the /mcp endpoint, not a page you open in a browser. Check the URL ends in /mcp.

Empty results

You're likely looking at the wrong workspace. Ask your assistant to list your workspaces first, then point it at the right one.

Browser login won't open

Some clients can only self-register and don't accept a client ID. For those, paste a StayHawk access token as a bearer token instead. See the FAQ below.

Frequently asked questions

Model Context Protocol is an open standard that lets an AI assistant talk to an outside service in a structured way. StayHawk runs an MCP server so your assistant can read your booking portfolio — deadlines, prices, and alerts — without you copying anything across.

Yes. The server can only read your bookings. It never creates, edits, or deletes anything, and it holds no data of its own — every request is scoped to your workspace by the StayHawk API.

Any client that speaks MCP over Streamable HTTP and lets you set a client_id — Claude, ChatGPT, Cursor, VS Code and others. Clients that can only self-register need a pasted token instead (see below).

Use 974dd144220a443590152e70213e835d. It is a public identifier, not a secret, so it is safe to paste anywhere.

A few clients can only register automatically and won't accept a client ID. For those, sign in to StayHawk, mint an access token for the API (audience https://api.stayhawk.app), and paste it into your client as a bearer token in the Authorization header.

Your assistant only ever sees what you ask about, authenticated with your own login. The connection is read-only and scoped to your workspace. You can revoke access at any time from your Kinde account.

Still have questions?

We usually reply within one business day.

Email support@stayhawk.app