Booking.com MCP Server
Booking.com Model Context Protocol

Get Booking.com hotel data by chatting with AI.

Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls Booking.com data from plain-English prompts. Same API key, same billing as the REST API.

Install it in your agent Read the MCP docs
50 free requests on signup No credit card Any language, no code

Trusted by hospitality teams at

What you can ask

Ask in plain English.
Get real Booking.com answers.

Whatever you'd ask a junior analyst about a hotel, 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

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.

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.

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Name it StayAPI and set the URL to https://api.stayapi.com/mcp.
  3. 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.

  1. In ChatGPT, turn on Settings → Security and login → Developer mode.
  2. Open chatgpt.com/plugins, click +, and choose Create MCP app.
  3. Name it StayAPI, set the URL to https://api.stayapi.com/mcp, and pick OAuth. Leave the client ID and secret blank.
  4. Sign in to StayAPI, choose Allow, then install StayAPI from your personal plugins.
  5. 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"
  1. Run the command in any terminal.
  2. Open a new Claude Code session.
  3. Confirm with claude mcp list.
02

Cursor

Edit ~/.cursor/mcp.json.

json 
{
  "mcpServers": {
    "stayapi": {
      "type": "http",
      "url": "https://api.stayapi.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
  1. Open or create the file.
  2. Paste, swap YOUR_API_KEY, save.
  3. Restart Cursor.
03

Claude Desktop

Edit claude_desktop_config.json.

json 
{
  "mcpServers": {
    "stayapi": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@0.1.18",
        "https://api.stayapi.com/mcp",
        "--header", "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Open the config file in your OS.
  2. Paste, swap the key, save.
  3. 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 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. country_market (default US) sets the pricing market; Booking.com prices by the visitor's country. Optional market selects country and language/currency defaults (ES: es/EUR; US: en-us/USD); explicit overrides win. effective_market reports best-effort targeting, not verified geography. Price objects include labels, genius_discount_pct, and is_mobile_rate for observed anonymous rate markers.

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, including description, check-in/check-out times, and property_type (a string such as HOTEL, APARTMENT, HOLIDAY_HOME, or CHALET, or null when unavailable; new categories may appear), 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. Optional market sets country and language/currency defaults; explicit overrides win. effective_market reports unverified targeting. Pass the same country_market as the search for matching prices. children_ages is a comma-separated string of integer ages 0–17; its count must equal children. Rate price objects include labels, genius_discount_pct, and is_mobile_rate.

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. limit (default 20, 0 = all) and size (thumbnail / medium / large / all) keep responses compact; metadata.photo_count is always the full gallery size.

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, paste one prompt, let your agent install itself. 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. Paste one prompt into your agent, then start asking it for Booking.com data.

Start free Read the MCP docs
  • 50 free requests, no credit card
  • Same key as the REST API
  • Any language, no code
02 · 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
  • Working setup on the call
  • Your properties, your prompts
  • Engineering, not sales