Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls KAYAK data from plain-English prompts. Same API key, same billing as the REST API.
Installs with a YOUR_API_KEY placeholder you swap in Cursor.
or paste the prompt
Paste into Cursor's chat
Read https://stayapi.com/install and set up the StayAPI MCP server for me.
The agent writes ~/.cursor/mcp.json, then asks you to restart Cursor.
Paste into Codex
Read https://stayapi.com/install and set up the StayAPI MCP server for me.
Codex reads the page and writes its own MCP config.
Paste into your agent
Read https://stayapi.com/install and set up the StayAPI MCP server for me.
Gemini CLI, Windsurf, or anything else that speaks MCP — the agent adds a remote HTTP server with the X-API-Key header to that client's own config.
No key yet?Sign up for 50 free requests — the agent asks you for it.
Claude on the web, desktop, or mobile doesn't need this prompt: add StayAPI under Settings → Connectors and sign in. ChatGPT: add it as an MCP app in developer mode and sign in. Other clients: manual setup below.
No key
Claude on the web, desktop & mobile
Add StayAPI as a connector and sign in. Nothing to paste.
In Claude, open Settings → Connectors → Add custom connector.
Name it StayAPI and set the URL to https://api.stayapi.com/mcp.
Click Connect, sign in to StayAPI, and choose Allow.
No key
ChatGPT (developer mode)
Add StayAPI as an MCP app and sign in. Plus, Pro, Business, Enterprise, or Edu, on the web.
In ChatGPT, turn on Settings → Security and login → Developer mode.
Open chatgpt.com/plugins, click +, and choose Create MCP app.
Name it StayAPI, set the URL to https://api.stayapi.com/mcp, and pick OAuth. Leave the client ID and secret blank.
Sign in to StayAPI, choose Allow, then install StayAPI from your personal plugins.
In a Work chat, type @StayAPI and ask.
Manual setup — paste the config yourself
01
Claude Code
One terminal command.
bash
claude mcp add --scope user --transport http stayapi https://api.stayapi.com/mcp --header "X-API-Key: YOUR_API_KEY"
On Windows, a bare npx can fail with spawn npx ENOENT. Use the absolute path to npx.cmd. Windows setup notes →
Full reference — every tool, error shapes, Windows notes: MCP documentation →
Tools for KAYAK
The KAYAK tools your agent can call.
Most agents pick the right tool from your prompt, so you never name it. One tool call counts as one request, the same as a REST request.
kayak_lookup_destination
Find city IDs by query (2–100 trimmed characters), with limit 1–50 (default 10).
kayak_buzz_calendar
Read LOW, MEDIUM, and HIGH daily relative price bands for a city_id. No monetary prices, currency, or date-range controls.
kayak_hotel_url_to_id
Extract a hotel_id and canonical URL from a KAYAK property url. existence_checked is false. Pass hotel_id to Reviews; Details, Photos, and Amenities require url.
kayak_hotel_details
Read published hotel content by KAYAK property url: name, plain-text description, address, coordinates, stars, and aggregate rating on a 0–10 scale. No live prices or availability.
kayak_hotel_photos
Read KAYAK property photos by url with image URLs, thumbnails, categories, and attribution. No pagination or size controls.
kayak_hotel_amenities
Read top amenities and categorized amenity entries by KAYAK property url. total counts categorized entries, excluding highlights.
kayak_hotel_reviews
Read KAYAK hotel reviews by hotel_id and page (1–1000, default 1), up to 10 per page. Follow has_more; scores use 0–100 and source labels are preserved. No sort selector.
Full parameters and response shapes live in the MCP docs.
For the same data over REST, see the KAYAK API hub.
Point your agent at KAYAK.
Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering KAYAK questions in plain English.
01 · the fast path
Get your key
50 free requests on signup. Paste one prompt into your agent, then start asking it for KAYAK data.