[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_110":111},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":59,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","stayingapi","moduleId","hotel-vacation-rental-mcp","@stayingapi/hotel-vacation-rental-mcp","displayName","Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrbo & Google Hotels","tagline","Search hotels & rentals: live prices & reviews across Booking.com, Airbnb, Vrbo & Google Hotels.","iconKey","https://raw.githubusercontent.com/stayingapi/hotel-vacation-rental-mcp/main/public/brand/logo-512.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.stayingapi.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1785990092000,"updatedAt",1788768557000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.stayingapi%2Fhotel-vacation-rental-mcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1787637781000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/stayingapi/hotel-vacation-rental-mcp","githubRepoFullName","stayingapi/hotel-vacation-rental-mcp","releaseId","ext-stayingapi-hotel-vacation-rental-mcp","version","1.0.0","descriptionMarkdown","\n\n

\n \n $\"StayingAPI\"$ \n \n

\n\n

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

\n\n

\n 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.
\n 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.\n

\n\n

\n $\"Install$ \n $\"300$ \n

\n\n

\n $\"Website\"/$ \n $\"Docs\"/$ \n $\"OpenAPI\"/$ \n $\"MIT$ \n $\"Glama$ \n

\n\n> **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 card**\n> [StayingAPI](https://stayingapi.com) is 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.\n\n---\n\n## Install in one line\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp\n```\n\n**Claude Desktop, ChatGPT, Cursor, or any other MCP client** — add this as a Streamable HTTP server:\n\n```txt\nhttps://mcp.stayingapi.com/mcp\n```\n\nNo API key to paste: the first call opens an OAuth sign-in (free account, 300 credits, no card). Per-client steps are in [Quick Install](#quick-install), and the whole repo also installs as an [Agent Plugin](#install-as-an-agent-plugin--easiest).\n\n---\n\n## Why a Hotel & Vacation Rental MCP\n\nYou are already comparing stays across four sites by hand: a hotel on Booking.com, an apartment on Airbnb, a villa on Vrbo, and Google Hotels to sanity-check the rate. Every one of them has a different page, a different rating scale, and no API you can just sign up for.\n\n**Connect once, then just ask.** Add this MCP server to Claude, ChatGPT, Cursor, or any MCP client a single time, and your AI assistant can search real stays, quote real prices for your dates, compare one property's rate across booking sites, and read normalized reviews - inside the conversation, with no code and no repeated setup.\n\nEverything comes back in **one unified schema**. A hotel room and a holiday villa return the same object shape, ratings carry their native scale instead of being silently rescaled, and the cross-OTA comparison returns each site's offer plus a computed lowest and median price, so you do not re-derive them yourself.\n\n**Quick taste:**\n\n```txt\nFind 2-bed stays in Lisbon for these dates under EUR 150,\ncompare the top one's price across Airbnb, Booking.com and Vrbo,\nand summarize its reviews.\n```\n\nThat single prompt spans three tools - `search_stays`, `compare_prices`, `get_reviews` - without you writing a line of code.\n\n---\n\n## Install as an Agent Plugin _{· **easiest**}\n\nThis repository root is a conformant **[Agent Plugins 1.0.0](https://agent-plugins.org/specification)** package — 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 server **and** a bundled `stays` skill 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.\n\n```text\nplugin.json # Agent Plugins 1.0.0 manifest\nmcp.json # hosted MCP server, streamable-http, OAuth (no keys)\nskills/stays/SKILL.md # when + how to use the 7 read-only tools\n.cursor-plugin/plugin.json # Cursor plugin manifest, same MCP + skill (+ marketplace.json)\n```\n\n**VS Code** — Command Palette → **Chat: Install Plugin From Source**, then paste:\n\n```txt\nhttps://github.com/stayingapi/hotel-vacation-rental-mcp\n```\n\nOr register a local clone in `settings.json`:\n\n```json\n\"chat.pluginLocations\": { \"/absolute/path/to/hotel-vacation-rental-mcp\": true }\n```\n\n**Cursor** — **Customize** in the sidebar → find the plugin → **Install**. For a local clone:\n\n```bash\ngit clone https://github.com/stayingapi/hotel-vacation-rental-mcp ~/.cursor/plugins/local/stayingapi\n```\n\nThen **Developer: Reload Window**.\n\n**Add to Cursor** — MCP server only, no clone. Paste this deeplink into your browser:\n\n```txt\ncursor://anysphere.cursor-deeplink/mcp/install?name=stayingapi&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGF5aW5nYXBpLmNvbS9tY3AifQ==\n```\n\n**ChatGPT, Codex, GitHub Copilot, Kiro, any other client** — point your client's plugin mechanism at this repository, or at a local clone. Agent Plugins 1.0.0 standardizes the *package format*, not installation, so each client owns its own install flow.\n\n### 30-second example\n\n```txt\nFind a 2-bedroom apartment in Split, Croatia for 12-15 June, 2 adults, under EUR 150 a night.\n```\n\nOne `search_stays` call returns Airbnb, Booking.com, Vrbo and Google Hotels merged into a single normalized list, each with its booking URL. **No API key to configure** — the first call opens an OAuth sign-in (free account, 300 credits, no card). Then the follow-ups that normally take twenty browser tabs:\n\n```txt\nIs that one cheaper on Booking or Airbnb? → compare_prices (one call, every OTA)\nIs it free all week, and what's the min stay? → check_availability (day by day)\n```\n\nAll seven tools are **read-only** — nothing here can book, cancel or change a reservation.\n\nThere are **no credentials in this package** — Agent Plugins 1.0.0 forbids embedded secrets, and authorization is client-managed. Verify the package yourself:\n\n```bash\ncurl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json\ncurl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json\nnpx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json\nnpx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json -d mcp.json\n```\n\n---\n\n## Quick Install\n\n> **Requirements:**\n>\n> - A StayingAPI account ([sign up](https://stayingapi.com/signup) - 300 free credits, no card)\n> - **Either** OAuth (Claude, ChatGPT - no key handling at all) **or** an API key (`stay_live_...` / `stay_test_...`) from your dashboard\n\n> **Recommended: add a rule so your AI invokes it automatically**\n>\n> Paste this into your client's custom instructions or rules file:\n>\n> ```txt\n> When I mention a hotel, an Airbnb/Booking.com/Vrbo/Google Hotels listing,\n> a place to stay, travel dates, or ask to compare accommodation prices or\n> read stay reviews, automatically use the StayingAPI MCP tools to fetch\n> real data before answering.\n> ```\n\n**Server URL:** `https://mcp.stayingapi.com/mcp` (Streamable HTTP transport)\n\n

Install in Claude (Desktop & Web) - Recommended

\n\nSettings → Connectors → **Add custom connector** → paste:\n\n```\nhttps://mcp.stayingapi.com/mcp\n```\n\nClaude runs the OAuth 2.1 sign-in for you in a browser popup, which links the connector to your StayingAPI account and its credit balance - **no API key needed.** The seven read-only tools then appear in your tool list.\n\nPrefer the desktop config file? Add to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"stayingapi\": {\n \"url\": \"https://mcp.stayingapi.com/mcp\"\n }\n }\n}\n```\n\n

\n\n

Install in Claude Code (CLI)

\n\nOAuth (recommended):\n\n```bash\nclaude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp\n```\n\nThen run `/mcp` inside Claude Code and complete the OAuth prompt.\n\nPrefer a bearer key, or running headless?\n\n```bash\nclaude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp \\\n --header \"Authorization: Bearer stay_live_YOUR_KEY_HERE\"\n```\n\n

\n\n

Install in ChatGPT

\n\n1. Enable **Developer Mode**: Settings → Apps & Connectors → Advanced settings.\n2. Go to **Settings → Connectors → Add MCP server** (Create in the Connectors panel).\n3. Paste the server URL:\n\n```\nhttps://mcp.stayingapi.com/mcp\n```\n\n4. Complete the OAuth sign-in when prompted - **no API key needed.**\n\n

\n\n

Install in Cursor (One-Click or Manual)

\n\n**One-click:** use the [Install in Cursor](https://cursor.com/en/install-mcp?name=stayingapi&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGF5aW5nYXBpLmNvbS9tY3AifQ==) badge at the top of this README.\n\n**Manual:** add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project):\n\n```json\n{\n \"mcpServers\": {\n \"stayingapi\": {\n \"url\": \"https://mcp.stayingapi.com/mcp\"\n }\n }\n}\n```\n\nTo use a bearer key instead of the OAuth flow, add a `headers` object with `\"Authorization\": \"Bearer stay_live_YOUR_KEY_HERE\"`.\n\n

\n\n

Any other MCP client

\n\nAdd `https://mcp.stayingapi.com/mcp` as a **Streamable HTTP** MCP server.\n\n- Clients that support OAuth 2.1 with Dynamic Client Registration authenticate automatically - nothing to configure.\n- Clients that do not can present a bearer key instead: `Authorization: Bearer stay_live_...`.\n\nOnly formats verified against [stayingapi.com/docs/mcp](https://stayingapi.com/docs/mcp) are listed above on purpose. If your client is not here, the generic Streamable HTTP setup is the whole configuration.\n\n

\n\n---\n\n## Authentication\n\nTwo ways in, both ending at the same account and the same credit balance:\n\n- **OAuth 2.1 + PKCE (S256) with Dynamic Client Registration** - recommended for Claude and ChatGPT. You authorize once in a browser popup and the connector is linked to your StayingAPI account. DCR-aware clients discover everything automatically, so **no key is ever pasted into the agent**.\n- **Bearer API key** - for key-based clients and scripts. Keys are `stay_live_...` (real fan-out to live sources) or `stay_test_...` (deterministic sandbox fixtures, always 0 credits). Send as `Authorization: Bearer stay_live_...`.\n\n**One balance, separate rate bucket.** MCP calls draw from the same single credit balance as your REST keys. REST is rate-limited per key; MCP is rate-limited per user - separate buckets, one wallet.\n\n> **Security note:** treat `stay_live_` keys like passwords. A new key's secret is shown once and stored only as a SHA-256 hash, so it is never recoverable. Never commit one to a repo or paste it into a shared config; revoke and re-mint from the dashboard if a key leaks.\n\n---\n\n## Available Tools\n\nAll seven are **read-only** (annotated `readOnlyHint: true`, `idempotentHint: true`). There are no write tools, so nothing here can book, cancel, or change anything. Each tool maps 1:1 to a REST endpoint, runs the same validation and cache pipeline, and returns the same unified `{ data, meta }` envelope.\n\n### 1. `search_stays`\n\nDiscover properties across platforms by location, dates, occupancy and filters, merged into one schema. This is the breadth endpoint and the clearest demonstration of \"one schema, every platform\".\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `location` | string | yes | Place name (`Split, HR`) or `lat,lng` |\n| `checkIn` / `checkOut` | date | no | `YYYY-MM-DD`; required together; not in the past |\n| `adults` / `children` / `childAges[]` / `rooms` | integer | no | `childAges[]` length must equal `children` |\n| `propertyType[]` | enum[] | no | `hotel` \\| `apartment` \\| `house` \\| `villa` \\| `cottage` \\| `other` |\n| `amenities[]` | enum[] | no | Canonical amenity taxonomy |\n| `minBedrooms` / `priceMin` / `priceMax` / `minGuestRating` | number | no | Filters applied post-normalization |\n| `platforms[]` | enum[] | no | `airbnb` \\| `booking` \\| `vrbo` \\| `google`; drives fan-out |\n| `limit` / `cursor` / `sort` / `currency` | mixed | no | `limit` 1-40; `sort` = `recommended` \\| `price_asc` \\| `price_desc` \\| `rating_desc` |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": [\n {\n \"id\": \"stays_booking_abramovic2\",\n \"platform\": \"booking\",\n \"platformListingId\": \"abramovic2\",\n \"url\": \"https://www.booking.com/hotel/hr/abramovic2.html\",\n \"name\": \"Apartments Abramović\",\n \"propertyType\": \"apartment\",\n \"location\": { \"lat\": 43.51, \"lng\": 16.44, \"city\": \"Split\", \"country\": \"HR\" },\n \"starRating\": null,\n \"guestRating\": 9.1, \"ratingScale\": 10, \"reviewCount\": 142,\n \"maxOccupancy\": 4, \"bedrooms\": 2, \"bathrooms\": 1,\n \"amenities\": [\"pool\", \"kitchen\", \"air_conditioning\", \"wifi\"],\n \"host\": { \"name\": \"Marko\", \"isSuperhost\": false },\n \"price\": { \"currency\": \"USD\", \"nightlyPrice\": 303, \"totalPrice\": 2122, \"nights\": 7 }\n }\n ],\n \"meta\": {\n \"platforms\": [\"airbnb\", \"booking\"],\n \"cached\": false, \"partial\": false, \"currency\": \"USD\",\n \"pagination\": { \"limit\": 20, \"cursor\": null, \"nextCursor\": \"eyJ…\", \"hasMore\": true },\n \"platformResults\": [\n { \"platform\": \"airbnb\", \"status\": \"ok\", \"cached\": false, \"count\": 18 },\n { \"platform\": \"booking\", \"status\": \"ok\", \"cached\": true, \"count\": 20 }\n ],\n \"warnings\": []\n }\n}\n```\n\n### 2. `check_availability`\n\nDay-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.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `platform` | enum | yes | Single platform; not a fan-out tool |\n| `listingId` / `listingIds[]` / `url` | string | one of | A listing id, a batch of ids, or a full listing URL |\n| `startDate` / `endDate` | date | yes | Not in the past; window up to 365 days |\n| `onlyAvailable` | boolean | no | If true, only bookable dates are returned |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": [\n {\n \"platform\": \"airbnb\",\n \"listingId\": \"42307961\",\n \"dates\": [\n { \"date\": \"2026-07-13\", \"available\": true, \"minNights\": 7, \"checkIn\": true, \"checkOut\": false, \"bookable\": true },\n { \"date\": \"2026-07-14\", \"available\": true, \"minNights\": 7, \"checkIn\": false, \"checkOut\": false, \"bookable\": true }\n ]\n }\n ],\n \"meta\": { \"platforms\": [\"airbnb\"], \"cached\": false, \"partial\": false, \"warnings\": [] }\n}\n```\n\n### 3. `get_listing`\n\nFull 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.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `platform` | enum | yes | `vrbo` \\| `booking` \\| `airbnb` \\| `google` |\n| `id` | string | yes | Platform-native listing id, verbatim from the source |\n| `checkIn` / `checkOut` | date | no | Presence embeds a best-effort live price |\n| `adults` / `children` / `childAges[]` / `currency` | mixed | no | Only used with dates |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": {\n \"id\": \"stays_booking_abramovic2\",\n \"platform\": \"booking\",\n \"platformListingId\": \"abramovic2\",\n \"name\": \"Apartments Abramović\",\n \"propertyType\": \"apartment\",\n \"location\": { \"lat\": 43.51, \"lng\": 16.44, \"city\": \"Split\", \"country\": \"HR\" },\n \"guestRating\": 9.1, \"ratingScale\": 10, \"reviewCount\": 142,\n \"maxOccupancy\": 4, \"bedrooms\": 2, \"bathrooms\": 1,\n \"amenities\": [\"pool\", \"kitchen\", \"air_conditioning\", \"wifi\"],\n \"images\": [\"https://…\"],\n \"host\": { \"name\": \"Marko\", \"isSuperhost\": false },\n \"price\": { \"currency\": \"USD\", \"nightlyPrice\": 303, \"totalPrice\": 2122, \"nights\": 7 }\n },\n \"meta\": { \"platforms\": [\"booking\"], \"cached\": false, \"partial\": false, \"warnings\": [] }\n}\n```\n\n### 4. `get_price`\n\nA real price quote for one listing, for your dates and occupancy. Pass the platform-native id returned by `search_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**.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `platform` | enum | yes | `vrbo` \\| `booking` \\| `airbnb` \\| `google` |\n| `listingId` | string | yes | Native id from `search_stays.platformListingId`, or pass `url` |\n| `checkIn` / `checkOut` | date | yes | `YYYY-MM-DD`; `checkOut` after `checkIn` |\n| `adults` / `children` / `childAges[]` / `currency` | mixed | no | ISO-4217 currency, passed through and echoed |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": {\n \"platform\": \"booking\",\n \"listingId\": \"abramovic2\",\n \"currency\": \"EUR\",\n \"nightlyPrice\": 303,\n \"totalPrice\": 2122,\n \"fees\": { \"cleaning\": null, \"service\": null, \"taxes\": null },\n \"nights\": 7,\n \"occupancy\": { \"adults\": 2, \"children\": 2, \"childAges\": [8, 13] },\n \"source\": \"booking\",\n \"url\": \"https://www.booking.com/hotel/hr/abramovic2.html\"\n },\n \"meta\": { \"platforms\": [\"booking\"], \"cached\": false, \"partial\": false, \"warnings\": [] }\n}\n```\n\n### 5. `compare_prices`\n\n**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-computed `min` and `median` as first-class fields, so you read the cheapest and typical cross-site price without re-deriving them.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `name` / `googleHotelId` / `location` | string | one of | Property name to resolve, a precise Google Hotels id, or a disambiguating place |\n| `checkIn` / `checkOut` | date | yes | `YYYY-MM-DD`; not in the past |\n| `adults` / `children` / `childAges[]` / `currency` | mixed | no | ISO-4217 currency, passed through and echoed |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": {\n \"property\": \"Hotel X, Sibenik\",\n \"checkIn\": \"2026-07-13\",\n \"checkOut\": \"2026-07-20\",\n \"currency\": \"EUR\",\n \"min\": 2122,\n \"median\": 2151,\n \"offers\": [\n { \"ota\": \"booking.com\", \"totalPrice\": 2122, \"currency\": \"EUR\", \"url\": \"https://…\" },\n { \"ota\": \"expedia\", \"totalPrice\": 2180, \"currency\": \"EUR\", \"url\": \"https://…\" }\n ]\n },\n \"meta\": { \"platforms\": [\"google\"], \"cached\": false, \"partial\": false, \"warnings\": [] }\n}\n```\n\n### 6. `get_reviews`\n\nNormalized, 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.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `platform` | enum | yes | Platform enum |\n| `listingId` / `url` | string | one of | Listing id on that platform, or a full listing URL |\n| `limit` / `cursor` | mixed | no | `limit` 1-100; opaque base64 cursor |\n| `language` / `minRating` / `sort` | mixed | no | ISO-639-1 filter; `sort` = `recent` \\| `rating_desc` \\| `rating_asc` |\n\nResponse (trimmed):\n\n```jsonc\n{\n \"data\": [\n {\n \"platform\": \"booking\",\n \"listingId\": \"abramovic2\",\n \"reviewId\": \"r987\",\n \"rating\": 9, \"ratingScale\": 10,\n \"title\": \"Perfect family stay\",\n \"text\": \"Spotless apartment a short walk from the old town…\",\n \"author\": \"Jane D.\", \"date\": \"2026-05-10\", \"tripType\": \"family\",\n \"language\": \"en\", \"ownerResponse\": \"Thank you!\",\n \"liked\": \"Location and cleanliness\", \"disliked\": null\n }\n ],\n \"meta\": {\n \"platforms\": [\"booking\"], \"cached\": false, \"partial\": false,\n \"pagination\": { \"limit\": 20, \"cursor\": null, \"nextCursor\": \"eyJ…\", \"hasMore\": true },\n \"warnings\": []\n }\n}\n```\n\n### 7. `get_job`\n\nPoll 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 calls `get_job` until `status` is `completed` or `failed`. **Polling always costs 0 credits** - the underlying work is billed once, on successful completion.\n\n| Param | Type | Required | Notes |\n| --- | --- | --- | --- |\n| `jobId` | string | yes | The handle returned by the original call. Results are retained 24 h |\n\nResponse while running, then on completion (trimmed):\n\n```jsonc\n// While running - polling is free\n{\n \"data\": { \"jobId\": \"job_3kf…\", \"status\": \"running\", \"pollUrl\": \"/v1/jobs/job_3kf…\", \"estimatedSeconds\": 12 },\n \"meta\": { \"creditsCharged\": 0, \"platforms\": [\"vrbo\"] }\n}\n\n// On success - the payload arrives in data.result, in the same unified schema\n{\n \"data\": { \"jobId\": \"job_3kf…\", \"status\": \"completed\", \"result\": [ /* the endpoint's payload */ ] },\n \"meta\": {\n \"platforms\": [\"vrbo\"], \"currency\": \"USD\",\n \"platformResults\": [ { \"platform\": \"vrbo\", \"status\": \"ok\", \"cached\": false, \"count\": 15 } ],\n \"warnings\": []\n }\n}\n```\n\nA failed job still returns successfully with `status: \"failed\"` and the reason nested at `data.error` (a `{ type, code, message, retryable }` object). Failed work is free.\n\n---\n\n## Data you get\n\nEvery call returns the same unified `{ data, meta }` envelope, whether the property is a hotel or a holiday home:\n\n| Field group | Examples |\n|---|---|\n| Identity | `id`, `platform`, `platformListingId`, canonical listing `url` |\n| Core facts | property type, bedrooms, bathrooms, max occupancy, geo (`lat`/`lng`/city/country) |\n| Ratings | `guestRating` with an explicit `ratingScale` (5 or 10, never silently rescaled), `reviewCount`, `starRating` |\n| Amenities | Canonical taxonomy across all four platforms (`pool`, `kitchen`, `air_conditioning`, `wifi`, ...) |\n| Price | `nightlyPrice`, `totalPrice`, `nights`, `currency`, and a `fees` breakdown (cleaning, service, taxes) |\n| Cross-platform compare | Per-site `offers[]` plus StayingAPI-computed `min` and `median` |\n| Availability | Day-by-day `available`, `minNights`, `checkIn`, `checkOut`, `bookable` |\n| Reviews | Rating on its native scale, title, text, author, date, trip type, language, owner response, liked/disliked |\n| Host & media | Host name, superhost flag, full-resolution photo URLs |\n| Call metadata | `requestId`, per-platform status, cache flags, pagination cursor, warnings |\n\n**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.\n\n---\n\n## Use Cases & Prompts\n\n| Use case | Example prompt |\n| --- | --- |\n| **Trip planning** | \"Find 2-bed stays in Lisbon 12-19 May under EUR 150 a night with a kitchen and air conditioning, and rank them by guest rating.\" |\n| **Price arbitrage across sites** | \"This hotel in Split, 13-20 July, 2 adults: what does it cost on Booking.com versus the other sites, and how far below the median is the cheapest?\" |\n| **Review summarization** | \"Pull the last 50 reviews for this listing and tell me the three complaints that keep coming up, and whether the host replies.\" |\n| **Availability check** | \"Is this Vrbo villa free for any 7-night window in August, and what is the minimum stay?\" |\n| **Family fit** | \"Same dates, 2 adults and 2 kids aged 8 and 13 - which of these three places actually sleeps us all, and what is the total with fees?\" |\n| **Market scan** | \"Scan apartments in Split for the first week of July - what is the typical nightly rate and how does my property compare?\" |\n| **Rate parity check** | \"For these five hotels, compare each one's rate across booking sites and flag any where one site is more than 10 percent off the median.\" |\n\n---\n\n## Pricing\n\n| | |\n| --- | --- |\n| **Starter credits** | **300 free credits at signup, no card** |\n| **Sandbox** | `stay_test_` keys return deterministic fixtures at **0 credits**, forever |\n| **Failed calls** | Failed, empty, blocked and not-found calls are **never billed** - `creditsCharged` is 0 |\n| **Async polling** | `get_job` polling is **always 0 credits**; the work is billed once, on success |\n| **Paid plans** | Credit-based. Current per-call costs and plan prices: [stayingapi.com/pricing](https://stayingapi.com/pricing) |\n\nThis README stays number-free on paid pricing by design, so it never drifts from the live [pricing page](https://stayingapi.com/pricing). MCP and REST draw from the **same single credit balance** - there is no separate MCP wallet or MCP pricing.\n\n[Sign up](https://stayingapi.com/signup) · [View pricing](https://stayingapi.com/pricing)\n\n---\n\n## Troubleshooting\n\nBranch on `error.type` (the class, mapped 1:1 to the HTTP status) and then on `error.code` (a stable, finer-grained reason). Every error also carries a `requestId`, a `retryable` flag, and a `docUrl`.\n\n

401 authentication_error - missing or bad credentials

\n\nCodes: `missing_api_key`, `invalid_api_key`, `revoked_api_key`.\n\n- Check the key starts with `stay_live_` or `stay_test_`, and that no stray whitespace was copied.\n- Confirm the key has not been revoked in your dashboard. A revoked key returns `revoked_api_key` immediately.\n- On OAuth clients, remove and re-add the connector to re-authorize.\n- Auth is checked before validation, billing or any upstream work, so a 401 is **never billed**.\n

\n\n

403 permission_denied - usually email verification

\n\nCodes: `email_unverified`, `scope_insufficient`, `subscription_required`.\n\n- `email_unverified` is the common one: live credit is locked until you confirm your account email. Your `stay_test_` sandbox key is unaffected and keeps returning full fixtures at zero cost, so you can build end-to-end before verifying.\n- `subscription_required` means a top-up was attempted without an active paid subscription - top-ups are a subscriber add-on.\n

\n\n

402 insufficient_credits

\n\nCode: `credit_balance_too_low`. The balance is below what the call would cost. Check it programmatically instead of guessing - the account endpoint returns `credits.balance`, `plan`, key `env` and your `rateLimit.requestsPerMinute`. Top up or upgrade at [stayingapi.com/pricing](https://stayingapi.com/pricing).\n

\n\n

400 invalid_request - the request itself

\n\nMost common codes: `missing_parameter`, `invalid_date_range` (`checkOut` must be strictly after `checkIn`), `date_in_past` (evaluated in UTC), `child_ages_mismatch` (`childAges[]` length must equal `children`), `window_too_long` (availability windows cap at 365 days), `invalid_cursor`, `limit_out_of_range`, `mutually_exclusive_params` (you passed both `listingId` and `url`, or neither), `needs_country`.\n\n`needs_country` deserves a note: a bare Booking.com slug passed to `get_listing` is ambiguous, because Booking.com slugs are **not globally unique** - the same slug exists per country. Pass the country, or pass the full listing URL.\n

\n\n

404 not_found - including the deliberate one

\n\nCodes: `listing_not_found`, `job_not_found`, `identity_mismatch`.\n\n`identity_mismatch` is intentional: the resolved listing's canonical identity did not match what was requested, so StayingAPI **refuses to return a different property** rather than serve plausible-looking wrong data. `job_not_found` also fires for an expired job (results are retained 24 h) or a job belonging to another account - a job id is not a capability.\n

\n\n

429 rate_limited

\n\nCode: `rate_limit_exceeded`. Retryable - honour the `Retry-After` header rather than looping tightly. MCP is rate-limited **per user** and REST **per key**: separate buckets, one shared credit balance.\n

\n\n

503 / 504 upstream problems

\n\n`upstream_unavailable` (`all_actors_failed`, `actor_blocked`) means every primary and fallback source failed or was blocked; `upstream_timeout` means synchronous upstream work exceeded the request deadline. Both are retryable with backoff, and both cost **0 credits**. For long scrapes, expect the async path instead: a job handle you poll with `get_job`.\n

\n\n

OAuth will not connect

\n\n- Make sure a popup blocker is not stopping the sign-in window, then clear cookies and retry the connector authorization.\n- OAuth discovery starts from the server's 401 response. If a client cannot connect at all, confirm it supports MCP OAuth 2.1 with Dynamic Client Registration - otherwise fall back to a bearer key.\n

\n\n

A job is stuck, or \"completed\" but empty

\n\n`estimatedSeconds` is a projection, not a guarantee - a job usually finishes in tens of seconds but can exceed 240 seconds on a slow platform, so budget in minutes. A **failed** job still returns HTTP 200 with `status: \"failed\"` and the reason at `data.error`, not in a top-level error envelope, so branch on `data.status === \"failed\"`. A completed job carries `meta.pagination: null` - cursor pagination only applies to synchronously returned list responses.\n

\n\n---\n\n## Also available as a REST API\n\nBuilding an app or a backend instead of an agent? The same data ships as a plain JSON REST service.\n\n| | MCP | REST API |\n| --- | --- | --- |\n| **Best for** | AI assistants and agents | Apps, backends, pipelines |\n| **Setup** | Add a URL, authorize once | Bearer key, code integration |\n| **Auth** | OAuth 2.1 + PKCE (no key in the agent) | `Authorization: Bearer stay_live_...` |\n| **Rate limit** | Per user | Per key |\n| **Credits** | **Same single balance** | **Same single balance** |\n| **Schema** | Identical unified schema | Identical unified schema |\n| **Get started** | This README | [Quickstart](https://stayingapi.com/docs/quickstart) · [API reference](https://stayingapi.com/docs) · [OpenAPI](https://api.stayingapi.com/openapi.json) |\n\nBase URL: `https://api.stayingapi.com/v1`. The seven MCP tools map 1:1 to `/v1/search`, `/v1/availability`, `/v1/listing/{platform}/{id}`, `/v1/price`, `/v1/price-compare`, `/v1/reviews` and `/v1/jobs/{jobId}`.\n\n---\n\n## Connect\n\n- **Website:** [stayingapi.com](https://stayingapi.com)\n- **MCP guide:** [stayingapi.com/docs/mcp](https://stayingapi.com/docs/mcp)\n- **Docs:** [stayingapi.com/docs](https://stayingapi.com/docs) · **OpenAPI:** [api.stayingapi.com/openapi.json](https://api.stayingapi.com/openapi.json)\n- **Workflows & recipes:** [stayingapi.com/workflows](https://stayingapi.com/workflows)\n- **Status:** [status.stayingapi.com](https://status.stayingapi.com)\n- **Contact:** [hello@stayingapi.com](mailto:hello@stayingapi.com)\n- **Listed in:** [awesome-agent-plugins](https://github.com/ZeroPointRepo/awesome-agent-plugins), a directory of verified Agent Plugins on the open standard, maintained by the same team\n\n**Related repositories** - part of the StayingAPI open resource set: [hotel-api](https://github.com/stayingapi/hotel-api) · [airbnb-api](https://github.com/stayingapi/airbnb-api) · [booking-com-api](https://github.com/stayingapi/booking-com-api) · [vrbo-api](https://github.com/stayingapi/vrbo-api) · [google-hotels-api](https://github.com/stayingapi/google-hotels-api) · [travel-api](https://github.com/stayingapi/travel-api) · [travel-workflows](https://github.com/stayingapi/travel-workflows) · [travel-skills](https://github.com/stayingapi/travel-skills)\n\n---\n\n## MCP Registry\n\nPublished to the official [Model Context Protocol Registry](https://registry.modelcontextprotocol.io/) as:\n\n```\ncom.stayingapi/hotel-vacation-rental-mcp\n```\n\nRegistry manifests in this repo: [`server.json`](https://github.com/stayingapi/hotel-vacation-rental-mcp/blob/main/server.json) (MCP registry) · [`smithery.yaml`](https://github.com/stayingapi/hotel-vacation-rental-mcp/blob/main/smithery.yaml) (Smithery) · [`glama.json`](https://github.com/stayingapi/hotel-vacation-rental-mcp/blob/main/glama.json) (Glama).\n\n---\n\n## FAQ\n\n**Is there an Airbnb or Booking.com API in 2026?**\nNot one you can sign up for and start using today. Airbnb has no open public API - access runs through its partner programs, which are aimed at approved software partners and property-management systems, not general developers. Booking.com's Demand API is similar: it requires a partner or affiliate agreement and an approval process before you get credentials. Vrbo sits inside Expedia Group's partner API program, and Google Hotels data flows through hotel partner feeds rather than a self-serve developer API. That gap is why \"airbnb api\" is one of the most-searched, least-served queries in travel tech. StayingAPI is the self-serve alternative: sign up, get a key with 300 free credits and no card, and query accommodation data across all four sources through one REST API or this MCP server, with every response normalized to the same schema.\n\n**What is a hotel or accommodation MCP?**\nA hotel or accommodation MCP is a Model Context Protocol server that exposes accommodation data as tools an AI agent can call directly: search stays, check day-by-day availability, fetch full listing detail, quote a real price for specific dates, compare that price across booking sites, and read normalized reviews. Instead of you copying results into a chat, the assistant fetches live data mid-conversation and reasons over it, which means it can chain steps on its own: search, then price the best candidate, then summarize its reviews. This one is hosted at `https://mcp.stayingapi.com/mcp`, speaks the Streamable HTTP transport, and exposes seven read-only tools covering Booking.com, Airbnb, Vrbo and Google Hotels in a single unified schema. It works with Claude, ChatGPT, Cursor, Claude Code and any other MCP client, and authenticates over OAuth 2.1, so no API key is ever pasted into the agent and nothing here can book, cancel or change a reservation.\n\n**What is the difference between the StayingAPI REST API and this MCP server?**\nThey are two front doors to the same service, not two products. The REST API is for apps, backends and data pipelines: you send a bearer key, you get JSON, you control the loop. The MCP server is for AI assistants and agents: you add one URL, authorize once over OAuth 2.1, and the seven tools become things the model can call on its own. Underneath they are identical - the same validation, the same adapter and cache pipeline, the same unified schema, the same error taxonomy, and the **same single credit balance**. There is no separate MCP wallet or MCP pricing. The only real difference is rate limiting: REST is metered per key, MCP per user. Pick REST when you are writing the code, MCP when the model is.\n\n**How is this different from a single-platform API or a scraper?**\nA single-platform API gives you one source's view, so cross-platform questions (\"is this villa cheaper on Booking.com or Vrbo?\") are unanswerable by construction. A SERP scraper hands you a raw page snapshot that you parse and normalize yourself, with no rating scale, no canonical amenity taxonomy, and no guarantee the row you parsed is the property you asked about. This server returns four sources in **one schema**, keeps native rating scales explicit instead of silently rescaling them, and ships `compare_prices`, which returns each site's offer plus a computed lowest and median. It also refuses to guess: if a listing's canonical identity does not match what you asked for, you get an `identity_mismatch` error rather than a plausible-looking wrong property. Failed, empty and blocked calls are never billed.\n\n**How do I compare hotel prices across Booking.com, Airbnb and Vrbo with AI?**\nConnect this MCP server to your assistant, then ask in plain language: \"compare this hotel's price for 13-20 July across booking sites\". The model calls `compare_prices` with the property name and your dates. It comes back with each site's total in your chosen currency plus StayingAPI-computed `min` and `median` fields, so the assistant can tell you not just the cheapest offer but how far below typical it sits. For short-term rentals where the same physical property is listed on several sites under different names, the usual flow is `search_stays` to find candidates, then `get_price` per platform for an exact quote at your dates and occupancy. Add the auto-invoke rule from [Quick Install](#quick-install) and your assistant will reach for these tools on its own whenever you mention a stay.\n\n**Can an AI agent search vacation rentals and short-term rentals, not just hotels?**\nYes, and that is deliberate - it is why this is a hotel **and** vacation rental MCP. Hotels arrive via Google Hotels and Booking.com; short-term rentals via Airbnb and Vrbo. Crucially they come back in the **same object shape**: a city-centre hotel room and a rural holiday villa both return property type, bedrooms, bathrooms, max occupancy, a canonical amenities list, a guest rating with its explicit scale, and a price with a fee breakdown. So an agent can answer \"what sleeps 4 with a pool near Split, hotel or apartment, whichever is cheaper\" in one pass, instead of you running two integrations and reconciling them. `search_stays` accepts a `platforms[]` filter and a `propertyType[]` filter, so you can narrow to just rentals, just hotels, or let both compete.\n\n**What data does it return?**\nEvery tool returns the same `{ data, meta }` envelope. Property records carry identity (platform, native listing id, canonical URL), core facts (property type, bedrooms, bathrooms, max occupancy, geo), a guest rating with an explicit `ratingScale` so a 9-out-of-10 is never confused with a 4.5-out-of-5, a canonical amenities list unified across all four platforms, host details, full-resolution photo URLs, and pricing with nightly, total, nights and a fees breakdown. Availability returns per-day `available`, `minNights`, `checkIn`, `checkOut` and `bookable`. Reviews return rating on its native scale, title, text, author, date, trip type, language, owner response, and liked/disliked. The `meta` block always reports the request id, per-platform status and cache flags, pagination cursor, and any warnings, so you can tell a partial result from a complete one.\n\n**How do I add it to Claude, ChatGPT or Cursor?**\nClaude Desktop and Claude Web: Settings, Connectors, Add custom connector, then paste `https://mcp.stayingapi.com/mcp` and complete the OAuth popup. Claude Code: `claude mcp add --transport http stayingapi https://mcp.stayingapi.com/mcp`, then run `/mcp` and authorize. ChatGPT: enable Developer Mode under Settings, Apps & Connectors, Advanced settings, then Settings, Connectors, Add MCP server, paste the same URL and complete the OAuth prompt. Cursor: use the one-click badge at the top of this README, or add `{\"mcpServers\":{\"stayingapi\":{\"url\":\"https://mcp.stayingapi.com/mcp\"}}}` to `~/.cursor/mcp.json` for every project, or to `.cursor/mcp.json` for just one. Any other MCP client works too - add the same URL as a Streamable HTTP server, and clients that support Dynamic Client Registration will negotiate OAuth without further configuration. Setup takes under a minute in every case, because the server is hosted: there is nothing to install, no runtime to manage, and no package to keep updated. Full per-client detail is in [Quick Install](#quick-install), and only configurations verified against the official docs are listed there, since a wrong config block costs you the one install attempt you get.\n\n**How much does it cost?**\nSignup gives you **300 free credits with no card**, and `stay_test_` sandbox keys return deterministic fixtures at zero cost forever, so you can build and test the whole integration before spending anything. After that it is credit-based, with current per-call costs and plan pricing on the [pricing page](https://stayingapi.com/pricing) - this README deliberately carries no paid numbers so they can never go stale here. Three things are always free regardless of plan: failed, empty and blocked calls (`creditsCharged` is 0), `get_job` polling, and every sandbox call. MCP and REST draw on the **same single balance**, so adding the MCP server does not create a second bill. Live credit unlocks after you verify your account email; the sandbox works fully before that.\n\n**Is StayingAPI affiliated with Airbnb, Booking.com, Vrbo or Google Hotels?**\nNo. StayingAPI is an independent service. **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.** We are not a partner, a reseller, or an authorized integration of any booking platform, we hold no agreement with any of them, and none of them endorse, review or approve this project. Platform names appear throughout this README, in the `platforms[]` enum, and in tool parameters purely as descriptive labels for which data source a given call targets, in the same way a price-comparison tool names the shops it checks. StayingAPI does not book, cancel or modify reservations: all seven tools are strictly read-only, annotated `readOnlyHint: true`, and there are no write tools at all. If you need to actually reserve a stay, follow the canonical listing `url` returned with every property and book on that platform directly.\n\n---\n\n

\n Get your key — 300 free credits, no card · MCP docs · Pricing · Status\n

\n\n

\n _{Released under the MIT License. StayingAPI is an independent service and is not affiliated with or endorsed by any booking platform. Platform names are trademarks of their respective owners.}\n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","iconType","image","upstream",{"_99":100,"_101":102,"_103":-5,"_104":105,"_106":107,"_108":109},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_97":59,"_98":59},"ratingAvg","reviewCount","topics",[],"license","MIT","language","registryName","com.stayingapi/hotel-vacation-rental-mcp","homepage","https://stayingapi.com","packages",[],"ENV",{"_112":113,"_114":115,"_116":117},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]