StayingAPI

Hotel & Vacation Rental MCP - live prices, availability & reviews across Booking.com, Airbnb, Vrbo & Google Hotels

Search stays, compare prices across Booking.com, Airbnb, Vrbo and Google Hotels, and pull reviews by just asking your AI. One hosted MCP, 300 free credits to start, no card.
Seven read-only tools - search, availability, listing detail, price, cross-OTA price compare, reviews, and job polling - for Claude, ChatGPT, Cursor, Claude Code, and any MCP client.

4 booking platforms, one schema · 7 read-only tools · cross-OTA price compare · OAuth 2.1, no key pasted into the agent · 300 free credits to start, no cardStayingAPIis an independent service for accommodation data. StayingAPI is not affiliated with, endorsed by, or sponsored by Airbnb, Booking.com, Vrbo, or Google Hotels. These are trademarks of their respective owners, used here descriptively to indicate the data sources StayingAPI's API and MCP server can query.

claude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp

No API key to paste: the first call opens an OAuth sign-in (free account, 300 credits, no card). Per-client steps are inQuick Install, and the whole repo also installs as anAgent Plugin.

Find 2-bed stays in Lisbon for these dates under EUR 150, compare the top one's price across Airbnb, Booking.com and Vrbo, and summarize its reviews.

This repository root is a conformantAgent Plugins 1.0.0package — the portable format published 2026-08-06 and supported by ChatGPT, Codex, Cursor, GitHub Copilot, Kiro and VS Code. One install gets you the MCP serveranda bundledstaysskill that teaches your agent which tool answers which question, how to keep cross-platform fan-out cheap, and that Airbnb/Vrbo rate on a 5-point scale while Booking.com rates on 10 — so it never compares a 9 with a 4.5.

plugin.json # manifest mcp.json # hosted MCP server, streamable-http, OAuth (no keys) skills/stays/SKILL.md # when + how to use the 7 read-only tools

https://github.com/stayingapi/hotel-vacation-rental-mcp

"chat.pluginLocations": { "/absolute/path/to/hotel-vacation-rental-mcp": true }

git clone https://github.com/stayingapi/hotel-vacation-rental-mcp ~/.cursor/plugins/local/stayingapi

Find a 2-bedroom apartment in Split, Croatia for 12-15 June, 2 adults, under EUR 150 a night.

Is that one cheaper on Booking or Airbnb? → compare_prices (one call, every OTA) Is it free all week, and what's the min stay? → check_availability (day by day)

curl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json curl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json npx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json npx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json -d mcp.json

- A StayingAPI account (sign up- 300 free credits, no card)
- EitherOAuth (Claude, ChatGPT - no key handling at all)oran API key (stay_live_.../stay_test_...) from your dashboard

When I mention a hotel, an Airbnb/Booking.com/Vrbo/Google Hotels listing, a place to stay, travel dates, or ask to compare accommodation prices or read stay reviews, automatically use the StayingAPI MCP tools to fetch real data before answering.

{ "mcpServers": { "stayingapi": { "url": "https://mcp.stayingapi.com/mcp" } } }

claude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp

claude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp \ --header "Authorization: Bearer stay_live_YOUR_KEY_HERE"

One-click:use theInstall in Cursorbadge at the top of this README.

{ "mcpServers": { "stayingapi": { "url": "https://mcp.stayingapi.com/mcp" } } }

Only formats verified againststayingapi.com/docs/mcpare listed above on purpose. If your client is not here, the generic Streamable HTTP setup is the whole configuration.

{ "data": [ { "id": "stays_booking_abramovic2", "platform": "booking", "platformListingId": "abramovic2", "url": "https://www.booking.com/hotel/hr/abramovic2.html", "name": "Apartments Abramović", "propertyType": "apartment", "location": { "lat": 43.51, "lng": 16.44, "city": "Split", "country": "HR" }, "starRating": null, "guestRating": 9.1, "ratingScale": 10, "reviewCount": 142, "maxOccupancy": 4, "bedrooms": 2, "bathrooms": 1, "amenities": ["pool", "kitchen", "air_conditioning", "wifi"], "host": { "name": "Marko", "isSuperhost": false }, "price": { "currency": "USD", "nightlyPrice": 303, "totalPrice": 2122, "nights": 7 } } ], "meta": { "platforms": ["airbnb", "booking"], "cached": false, "partial": false, "currency": "USD", "pagination": { "limit": 20, "cursor": null, "nextCursor": "eyJ…", "hasMore": true }, "platformResults": [ { "platform": "airbnb", "status": "ok", "cached": false, "count": 18 }, { "platform": "booking", "status": "ok", "cached": true, "count": 20 } ], "warnings": [] } }

Day-by-day availability for a known listing (or a batch of listings) on one platform over a date window. Each day reports whether it is available, its minimum-night requirement, and whether check-in, check-out and booking are allowed.

{ "data": [ { "platform": "airbnb", "listingId": "42307961", "dates": [ { "date": "2026-07-13", "available": true, "minNights": 7, "checkIn": true, "checkOut": false, "bookable": true }, { "date": "2026-07-14", "available": true, "minNights": 7, "checkIn": false, "checkOut": false, "bookable": true } ] } ], "meta": { "platforms": ["airbnb"], "cached": false, "partial": false, "warnings": [] } }

Full normalized detail for one listing: amenities on a canonical taxonomy, photos, host, geo, ratings, and - when you pass dates - an embedded live price. Detail is cached 24 h and any embedded price at the 1 h price TTL, composed at read time, so a stale price never rides on fresh detail.

{ "data": { "id": "stays_booking_abramovic2", "platform": "booking", "platformListingId": "abramovic2", "name": "Apartments Abramović", "propertyType": "apartment", "location": { "lat": 43.51, "lng": 16.44, "city": "Split", "country": "HR" }, "guestRating": 9.1, "ratingScale": 10, "reviewCount": 142, "maxOccupancy": 4, "bedrooms": 2, "bathrooms": 1, "amenities": ["pool", "kitchen", "air_conditioning", "wifi"], "images": ["https://…"], "host": { "name": "Marko", "isSuperhost": false }, "price": { "currency": "USD", "nightlyPrice": 303, "totalPrice": 2122, "nights": 7 } }, "meta": { "platforms": ["booking"], "cached": false, "partial": false, "warnings": [] } }

A real price quote for one listing, for your dates and occupancy. Pass the platform-native id returned bysearch_stays(numeric on Airbnb and Vrbo, a slug string on Booking.com and Google Hotels) or a full listing URL. The response is always a real numeric price or a typed error -never a different property's price.

{ "data": { "platform": "booking", "listingId": "abramovic2", "currency": "EUR", "nightlyPrice": 303, "totalPrice": 2122, "fees": { "cleaning": null, "service": null, "taxes": null }, "nights": 7, "occupancy": { "adults": 2, "children": 2, "childAges": [8, 13] }, "source": "booking", "url": "https://www.booking.com/hotel/hr/abramovic2.html" }, "meta": { "platforms": ["booking"], "cached": false, "partial": false, "warnings": [] } }

The flagship tool.Compare one property's price across booking sites in a single call, resolved through the Google Hotels backbone. The response carries the individual offers plus StayingAPI-computedminandmedianas first-class fields, so you read the cheapest and typical cross-site price without re-deriving them.

{ "data": { "property": "Hotel X, Sibenik", "checkIn": "2026-07-13", "checkOut": "2026-07-20", "currency": "EUR", "min": 2122, "median": 2151, "offers": [ { "ota": "booking.com", "totalPrice": 2122, "currency": "EUR", "url": "https://…" }, { "ota": "expedia", "totalPrice": 2180, "currency": "EUR", "url": "https://…" } ] }, "meta": { "platforms": ["google"], "cached": false, "partial": false, "warnings": [] } }

Normalized, paginated reviews for one listing on one platform.Native rating scales are preserved and echoed alongside each rating(Airbnb, Vrbo and TripAdvisor use 5; Booking.com, Expedia and Hotels.com use 10) and never silently rescaled, so a 9 and a 4.5 are not accidentally compared.

{ "data": [ { "platform": "booking", "listingId": "abramovic2", "reviewId": "r987", "rating": 9, "ratingScale": 10, "title": "Perfect family stay", "text": "Spotless apartment a short walk from the old town…", "author": "Jane D.", "date": "2026-05-10", "tripType": "family", "language": "en", "ownerResponse": "Thank you!", "liked": "Location and cleanliness", "disliked": null } ], "meta": { "platforms": ["booking"], "cached": false, "partial": false, "pagination": { "limit": 20, "cursor": null, "nextCursor": "eyJ…", "hasMore": true }, "warnings": [] } }

Poll a long-running scrape that was returned as an async job. When a request is projected to run longer than roughly 8 seconds it returns a job handle; the agent callsget_jobuntilstatusiscompletedorfailed.Polling always costs 0 credits- the underlying work is billed once, on successful completion.

Response while running, then on completion (trimmed):

// While running - polling is free { "data": { "jobId": "job_3kf…", "status": "running", "pollUrl": "/v1/jobs/job_3kf…", "estimatedSeconds": 12 }, "meta": { "creditsCharged": 0, "platforms": ["vrbo"] } } // On success - the payload arrives in data.result, in the same unified schema { "data": { "jobId": "job_3kf…", "status": "completed", "result": [ / the endpoint's payload / ] }, "meta": { "platforms": ["vrbo"], "currency": "USD", "platformResults": [ { "platform": "vrbo", "status": "ok", "cached": false, "count": 15 } ], "warnings": [] } }

A failed job still returns successfully withstatus: "failed"and the reason nested atdata.error(a{ type, code, message, retryable }object). Failed work is free.

Every call returns the same unified{ data, meta }envelope, whether the property is a hotel or a holiday home:

Coverage:Booking.com, Airbnb, Vrbo and Google Hotels - hotels and short-term rentals in the same schema, so one integration covers both halves of the accommodation map.

This README stays number-free on paid pricing by design, so it never drifts from the livepricing page. MCP and REST draw from thesame single credit balance- there is no separate MCP wallet or MCP pricing.

Code:credit_balance_too_low. The balance is below what the call would cost. Check it programmatically instead of guessing - the account endpoint returnscredits.balance,plan, keyenvand yourrateLimit.requestsPerMinute. Top up or upgrade atstayingapi.com/pricing.

Most common codes:missing_parameter,invalid_date_range(checkOutmust be strictly aftercheckIn),date_in_past(evaluated in UTC),child_ages_mismatch(childAges[]length must equalchildren),window_too_long(availability windows cap at 365 days),invalid_cursor,limit_out_of_range,mutually_exclusive_params(you passed bothlistingIdandurl, or neither),needs_country.

needs_countrydeserves a note: a bare Booking.com slug passed toget_listingis ambiguous, because Booking.com slugs arenot globally unique- the same slug exists per country. Pass the country, or pass the full listing URL.