Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls HolidayCheck 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. 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.
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 HolidayCheck
The HolidayCheck 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.
holidaycheck_hotels_search
Find hotels by query (1–200 characters after trimming), with page default 1 and up to 10 matches per page. available_count and has_more describe the available result set, not a global total. Pass returned hotel_id directly to details or reviews. No dates, prices, or destination search.
holidaycheck_hotel_details
Read hotel details by hotel_id UUID: canonical URL, address, location, contact, descriptions, grouped amenities, and check-in/out wording. Star classification is separate from native six-point guest ratings. No prices or photo gallery. Each successful call costs one credit.
holidaycheck_hotel_url_to_id
Extract a hotel UUID from a supported HolidayCheck hotel or review-listing URL. Does not verify hotel existence.
holidaycheck_hotel_reviews
Read HolidayCheck reviews by hotel_id UUID, with page (default 1) and sort most_relevant (default) or recent_desc. Up to 10 reviews per page, native six-point ratings, text sections, and recommendation percentage. No language control or owner responses.
Full parameters and response shapes live in the MCP docs.
For the same data over REST, see the HolidayCheck API hub.
Point your agent at HolidayCheck.
Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering HolidayCheck 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 HolidayCheck data.