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.
Booking.com MCP Server
Get Booking.com hotel data by chatting with AI.
Paste one snippet into Claude, Cursor, or Claude Code. Your agent pulls Booking.com 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 Booking.com answers.
Whatever you'd ask a junior analyst about a property, ask your agent. No syntax to learn.
>
What do guests complain about at Angsana Laguna Phuket on Booking?
>
Pull the latest 25 Booking reviews for Angsana Laguna Phuket and summarize the recurring themes.
>
Find hotels in Lisbon on Booking for May 12 to 15, two adults, under 200 euros.
>
What room types does Angsana Laguna Phuket have on Booking, and which are refundable?
>
Compare Booking review scores for three hotels: Angsana Laguna Phuket, Cassia Phuket, and Banyan Tree Phuket.
Behind the scenes
You type plain English. Your agent calls the right Booking.com tool.
Real examples. You ask, the agent picks a tool and fills the parameters, you read the answer. These outputs are illustrative.
01
Reviews
You ask
What do guests complain about at Angsana Laguna Phuket on Booking?
Behind the scenes
booking_hotel_reviews(hotel_id="346648", per_page=25, sort="recent_desc")
You see
Recurring themes in the latest batch: a wait at check-in, slow lobby WiFi, and a long walk to the far pool. Most guests still rate the stay highly.
02
Search
You ask
Find hotels in Lisbon on Booking for May 12 to 15, two adults, under 200 euros.
Behind the scenes
booking_lookup_destination(query="Lisbon") -> booking_search_hotels(dest_id=..., checkin="2026-05-12", checkout="2026-05-15")
You see
A shortlist of matches under 200 euros for those dates, each with its review score and nightly price, sorted so the best-value stays come first.
03
Rooms
You ask
What room types does Angsana Laguna Phuket have on Booking, and which are refundable?
Behind the scenes
booking_hotel_rooms(hotel_id="346648", checkin="2026-05-12", checkout="2026-05-15")
You see
The bookable room types for those dates, each flagged refundable or non-refundable, plus a deduplicated count of rooms still available.
Connect it
Pick your client. Paste one block.
Three config systems, three snippets. Swap YOUR_API_KEY for your real key and start asking.
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 →
Shortcut Don't have a key yet? Sign up for 50 free requests. Your dashboard ships these snippets pre-filled.
Tools for Booking.com
The Booking.com 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.
booking_search_hotels
List hotels in a destination for a stay window. Takes a dest_id.
booking_lookup_destination
Free-form name (e.g., "Lisbon") to a Booking.com dest_id. First step before booking_search_hotels when you only have a city name.
booking_hotel_details
Get one hotel's details by hotel_id (fast) or canonical Booking URL (slower, for URL to ID resolution).
booking_hotel_reviews
Get reviews for a hotel by hotel_id or URL, with sort and pagination. Use sort=recent_desc for date-bounded backfills.
booking_hotel_rooms
Get room types and live availability for one hotel by hotel_id or URL, for a stay window. Returns bookable rate blocks plus a deduplicated available-room count.
booking_hotel_photos
Get a hotel's full photo gallery by hotel_id or URL. Returns signed, ready-to-use image URLs at thumbnail, medium, and large sizes.
Full parameters and response shapes live in the MCP docs. For the same data over REST, see the Booking.com API hub.
Point your agent at Booking.com.
Sign up, copy one snippet, drop your key in. Both paths end with your agent answering Booking.com questions in plain English.
01 · the fast path
Get your key
50 free requests on signup. Copy one snippet, drop your key in, and start asking your agent for Booking.com 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