Claude Code
One terminal command.
claude mcp add --scope user --transport http stayapi https://api.stayapi.com/mcp --header "X-API-Key: YOUR_API_KEY"
- Run the command in any terminal.
- Open a new Claude Code session.
- Confirm with
claude mcp list.
Agoda MCP Server
Get Agoda hotel data by chatting with AI.
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.
Trusted by hospitality teams at
What you can ask
Ask in plain English.
Ask in plain English.
Get real Agoda answers.
Whatever you'd ask a junior analyst about a hotel, ask your agent. No syntax to learn.
>
Find live Agoda room prices for hotel 10884 for my dates and show the all-inclusive stay total.
>
What do guests say about Omena Hotel Jyvaskyla on Agoda?
>
Turn this Agoda hotel URL into a hotel ID and pull the latest reviews for it.
>
Summarize the recurring complaints in the last 40 Agoda reviews for Omena Hotel Jyvaskyla.
>
Show the Agoda sub-ratings for Omena Hotel Jyvaskyla and tell me which one drags the score down.
>
Pull the Agoda review comments for hotel 319457 and group them by the language they were written in.
Behind the scenes
You type plain English. Your agent calls the right Agoda tool.
Real examples. You ask, the agent picks a tool and fills the parameters, you read the answer. These outputs are illustrative.
01
Prices
You ask
Find live Agoda room prices for hotel 10884 for my dates and show the all-inclusive stay total.
Behind the scenes
agoda_hotel_prices(hotel_id=10884, check_in="2026-09-15", check_out="2026-09-17", currency="USD")
You see
The available room and rate plans for the stay, with the lowest all-inclusive total, nightly price, taxes and fees, breakfast, and cancellation terms.
02
Reviews
You ask
What do guests say about Omena Hotel Jyvaskyla on Agoda?
Behind the scenes
agoda_hotel_reviews(hotel_id="319457", page=1)
You see
The latest Agoda reviews for the property with its overall score, plus the points guests keep repeating in the review text.
03
URL to ID
You ask
Turn this Agoda hotel URL into a hotel ID and pull the latest reviews for it.
Behind the scenes
agoda_hotel_url_to_id(url="https://www.agoda.com/...") -> agoda_hotel_reviews(hotel_id=...)
You see
The hotel ID resolved out of the link, then the recent reviews for it, so a URL you paste turns into readable feedback in one go.
04
Comments
You ask
Pull the Agoda review comments for hotel 319457 and group them by the language they were written in.
Behind the scenes
agoda_hotel_review_comments(hotel_id="319457", page=1)
You see
The comment stream for that hotel sorted into the languages guests wrote in, so you can see which markets are talking about the property.
Connect it
Paste one sentence. Your agent does the rest.
Copy the prompt into the agent you already have open. It reads our setup page and wires up the connector itself.
Paste into Claude Code
Read https://stayapi.com/install and set up the StayAPI MCP server for me.
Then open a new session and run claude mcp list — stayapi should read ✓ Connected.
Add to Cursor in one click
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 Desktop and ChatGPT can't self-install — no shell, and connectors need OAuth. Manual setup below.
Manual setup — paste the config yourself
Cursor
Edit ~/.cursor/mcp.json.
{
"mcpServers": {
"stayapi": {
"type": "http",
"url": "https://api.stayapi.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
- Open or create the file.
- Paste, swap
YOUR_API_KEY, save. - Restart Cursor.
Claude Desktop
Edit claude_desktop_config.json.
{
"mcpServers": {
"stayapi": {
"command": "npx",
"args": [
"-y", "mcp-remote@0.1.18",
"https://api.stayapi.com/mcp",
"--header", "X-API-Key:YOUR_API_KEY"
]
}
}
}
- Open the config file in your OS.
- Paste, swap the key, save.
- Quit Claude with ⌘ Q, relaunch.
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_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.
agoda_hotel_reviews
Get guest reviews for one Agoda hotel by hotel_id, aggregated across the providers Agoda syndicates. Agoda always serves 20 per page. Sorting is 7 for most recent (default), 6 for highest rating, 5 for lowest rating.
agoda_hotel_review_comments
Get an Agoda hotel's reviews from one review provider instead of the cross-provider aggregate. Same shape and 20-per-page pagination as agoda_hotel_reviews; provider_id picks the source and defaults to 3038, Agoda's own reviews.
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.
Start free Read the MCP docs02 · talk to us
Talk through your use case
15 minutes. We screen-share and wire Claude or Cursor to your real properties. Free of charge.
Book a demo