Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls Agoda 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 Agoda
The Agoda 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.
agoda_search_hotels
Search a city by city_id and stay dates, with occupancy, currency, and page. Returns hotel cards and matching rates; unavailable hotels have null prices.
agoda_hotel_lookup
Find hotel suggestions by name. Returns hotel IDs and location context without prices or availability; no pagination.
agoda_hotel_url_to_id
An agoda.com hotel URL to the numeric Agoda hotel_id. First step before the other Agoda tools.
agoda_hotel_prices
Get live dated Agoda room availability by hotel_id, including the lowest all-inclusive stay price, per-night and whole-stay taxes/fees, breakfast, cancellation terms, and explicit sold-out status. Optional children_ages is a JSON integer array of up to nine ages 0–17 and overrides children, including [] for adults only. Omit it to use age 8 for each child in children.
agoda_hotel_reviews
Get Agoda's own guest reviews for one Agoda hotel by hotel_id. Agoda requests 20 per page; counts can differ. Agoda lists English-language reviews first (newest first with the default sort), then reviews in other languages, so for a complete date range, page until has_more is false. Sorting is 7 for most recent (default), 6 for highest rating, 5 for lowest rating.
agoda_hotel_review_comments
Get Agoda's own guest reviews for one Agoda hotel; returns the same reviews, shape, and pagination as agoda_hotel_reviews.
agoda_hotel_details
Get a date-free property profile by hotel ID, with address, available amenities, selected photos, and useful_information (nullable room count, opening year, check-in/check-out times, and ordered source groups).
Full parameters and response shapes live in the MCP docs.
For the same data over REST, see the Agoda API hub.
Point your agent at Agoda.
Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering Agoda 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 Agoda data.