Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls Hilton 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 Hilton
The Hilton 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.
hilton_search
Search undated Hilton hotel metadata in English by query or coordinates. Returns hotel_code, photos, amenities, and opening status, without prices or stay availability.
hilton_rooms
Get dated Hilton room types, starting cash offers, and standard or premium full-points rewards. Use hotel_code, dates, 1–4 adults, and USD or GBP; one room with no children. Reward points include exact stay totals and dated nightly breakdowns. Confirmed unavailability is a successful result with availability_status unavailable, room_types [], and total 0; availability_message explains the result. No Points & Money quotes.
hilton_hotel_url_to_id
Extract the seven-character Hilton hotel_code (ctyhocn) from a canonical HTTPS Hilton hotel or reservation rooms URL without checking existence.
Full parameters and response shapes live in the MCP docs.
For the same data over REST, see the Hilton API hub.
Point your agent at Hilton.
Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering Hilton 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 Hilton data.