HasData Booking.com

Booking.com MCP Server

A hosted Booking.com MCP server that gives Claude, Cursor, Windsurf and any other MCP client two read-only Booking.com tools. Search stays by destination and dates with rich filters, and read a single property in full, all as structured JSON, with nothing to host.

It reads public property pages on Booking.com that a signed-out visitor can see.

1,000 free credits every month, no card required, which is 100 Booking.

https://mcp.hasdata.com/mcp?apis=booking

• Prompts and resources

Contents

• What you need
• Quick start
• Example prompts
• Tools
• Errors and failure paths
• Pricing, free tier and limits
• Tool selection
• How it compares
• FAQ
• HasData links
• Development
• Contributing
• License

What you need

An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers 100 calls a month at the 10-credit rate. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/booking-mcp on npm and hasdata-booking-mcp on PyPI, shown below.

Quick start

The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.

Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.

Claude Code

claude mcp add --transport http booking "https://mcp.hasdata.com/mcp?apis=booking" \

--header "x-api-key: HASDATA_API_KEY"

Claude Desktop

Settings, then Connectors, then Add custom connector, then paste https://mcp.hasdata.com/mcp?apis=booking and sign in.

For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The @hasdata/booking-mcp package is that launcher, and it reads the key from the environment. Add this to claude_desktop_config.json:

{

"mcpServers": { "booking": { "command": "npx", "args": ["-y", "@hasdata/booking-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:

{

"mcpServers": { "booking": { "command": "uvx", "args": ["hasdata-booking-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

Cursor

~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{

"mcpServers": { "booking": { "url": "https://mcp.hasdata.com/mcp?apis=booking", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:

{

"mcpServers": { "booking": { "serverUrl": "https://mcp.hasdata.com/mcp?apis=booking", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

VS Code

.vscode/mcp.json in the workspace:

{

"servers": { "booking": { "type": "http", "url": "https://mcp.hasdata.com/mcp?apis=booking", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Example prompts

Prompts, not code. Paste one in and the agent picks the tool itself. Each is annotated with the calls it takes, because every successful call costs 10 credits.

Search Booking.com for hotels in Paris from September 15 to 18 for two adults, and give me the ten best-reviewed under $700 for the stay.

*One call, 10 credits. Price, review score and location come back on the search result.*

Take the top result and pull its full detail: facilities, house rules, the room options, and the category ratings.

*One call, 10 credits. Those live on the property page, which the details tool reads by URL and dates.*

Find four-star hotels in Paris with free cancellation near the center, and list price and review score.

*One call, 10 credits. Star rating, cancellation policy and distance are filters on the one request.*

Compare the cheapest stay in Paris against Rome for the same dates.

*Two calls, 20 credits, one search per city.*

The property tool needs the same dates and guest counts as the search, because availability and price depend on the window. A search to shortlist plus a detail call on three properties is one search and three property calls.

Tools

Two tools, read-only. Samples below are trimmed from real calls, and prices move constantly. Read them as shapes. Each tool name links to its endpoint reference, which carries the full field list.

The samples are the payload, not the whole response. A tools/call result carries one text block, and that text is itself JSON holding url, status, text and json, with the scraped data under json. From a raw JSON-RPC response the path is result.content[0].text, parsed, then .json. A chat client unwraps that for you and code talking to the endpoint directly does not.

Get Booking.com search results

hasdata_booking_search_getBookingSearchResults

A page of stays by destination and dates.

The reference documents the full filter set, including distance, meals, accessibility, bed preference and travel group.

Returns searchInformation, a results array, and pagination with page, totalResults and totalPages. Each result carries hotelId, title, url, the offered room and bedTypes, a location object, a policies object, a price object, the star rating, a reviews object with score, count and a text label, and a photo.

The discount pair in price is discountRaw and discountParsed. Earlier releases misspelled it as dicsountRaw and dicsountParsed, and that spelling is gone, so code written against it reads nothing. Also note rating is the official star rating while reviews.score is the guest score out of 10, two different numbers.

{

"hotelId": 50724, "title": "Hôtel du Jardin des Plantes", "url": "https://www.booking.com/hotel/fr/timjardindesplantes.html", "room": "Comfort Double Room", "location": { "city": "Paris", "address": "5 rue Linné", "mainDistance": "0.9 miles from downtown", "centrallyLocated": true }, "policies": { "freeCancellation": true, "noPrepayment": true }, "price": { "pricePerStayParsed": 451.36, "priceBeforeDiscountParsed": 885.03, "discountParsed": 433.66, "currency": "USD" }, "rating": 3, "reviews": { "score": 7.5, "count": 1721, "text": "Good" } }

Get Booking.com property details

hasdata_booking_place_getBookingPlaceDetails

One property in full, by its URL and the stay window.

Returns the page as sections rather than one flat object: overview (id, title, propertyType, a structured address, a description, highlights, mostPopularFacilities and photos), bookingDetails (the window and currency the prices reflect), a rooms array of the available suites each with name, beds, facilities and priced variants, a facilities list, houseRules, a ratings array of category scores, reviews, and questionsAndAnswers.

{

"overview": { "id": "50724", "title": "Hôtel du Jardin des Plantes", "propertyType": "HOTEL", "address": { "country": "France", "zipcode": "75005" }, "mostPopularFacilities": ["Non-smoking rooms", "Free Wifi", "24-hour front desk"] }, "bookingDetails": { "checkIn": "2026-09-15", "checkOut": "2026-09-18", "adults": 2, "rooms": 1, "currency": "USD" }, "ratings": [ { "label": "Average", "value": 7.5, "votes": 1721 }, { "label": "Cleanliness", "value": 7.8 } ] }

Prompts and resources

The server exposes 16 resources, one per parameter whose accepted values are a fixed list. Reading one is cheaper than learning the vocabulary from a rejected call, and it costs no credits. Each URI is `hasdata