Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrb…

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 card

StayingAPI 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.

---

Install in one line

Claude Code

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

Claude Desktop, ChatGPT, Cursor, or any other MCP client — add this as a Streamable HTTP server:

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 in Quick Install, and the whole repo also installs as an Agent Plugin.

---

Why a Hotel & Vacation Rental MCP

You 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.

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.

Everything 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.

Quick taste:

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.

That single prompt spans three tools - search_stays, compare_prices, get_reviews - without you writing a line of code.

---

Install as an Agent Plugin · easiest

This 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.

plugin.json                    # Agent Plugins 1.0.0 manifest

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

VS Code — Command Palette → Chat: Install Plugin From Source, then paste:

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

Or register a local clone in settings.json:

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

Cursor — Customize in the sidebar → find the plugin → Install. For a local clone:

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

Then Developer: Reload Window.

Add to Cursor — MCP server only, no clone. Paste this deeplink into your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=stayingapi&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGF5aW5nYXBpLmNvbS9tY3AifQ==

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.

30-second example

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

One 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:

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)

All seven tools are read-only — nothing here can book, cancel or change a reservation.

There are no credentials in this package — Agent Plugins 1.0.0 forbids embedded secrets, and authorization is client-managed. Verify the package yourself:

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

---

Quick Install

Requirements:

- A StayingAPI account (sign up - 300 free credits, no card)

- An MCP client that supports OAuth 2.1 (Claude, ChatGPT, Cursor and most others). The MCP server signs you in with OAuth only; API keys (stay_live_... / stay_test_...) are for the REST API

Recommended: add a rule so your AI invokes it automatically

Paste this into your client's custom instructions or rules file:

`txt

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.

`

Server URL: https://mcp.stayingapi.com/mcp (Streamable HTTP transport)

Install in Claude (Desktop & Web) - Recommended

Settings → Connectors → Add custom connector → paste:

https://mcp.stayingapi.com/mcp

Claude 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.

Prefer the desktop config file? Add to claude_desktop_config.json:

{

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

Install in Claude Code (CLI)

OAuth (recommended):

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

Then run /mcp inside Claude Code and complete the OAuth prompt.

Running headless, or want a key instead? The MCP server accepts OAuth sign-in only, so for scripts and backends use the REST API with a stay_live_ key.

Install in ChatGPT

1. Enable Developer Mode: Settings → Apps & Connectors → Advanced settings.
2. Go to Settings → Connectors → Add MCP server (Create in the Connectors panel).
3. Paste the server URL:

https://mcp.stayingapi.com/mcp

1. Complete the OAuth sign-in when prompted - no API key needed.

Install in Cursor (One-Click or Manual)

One-click: use the Install in Cursor badge at the top of this README.

Manual: add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{

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

The first tool call opens the OAuth sign-in. There is no API-key option for the MCP server.

Any other MCP client

Add https://mcp.stayingapi.com/mcp as a Streamable HTTP MCP server.

• Authentication is OAuth 2.1 + PKCE with Dynamic Client Registration: clients that support it authenticate automatically - nothing to configure.
• The MCP server does not accept API keys. A client without MCP OAuth support cannot connect; use the REST API with a stay_live_ key instead.

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

---

Authentication

The MCP server and the REST API end at the same account and the same credit balance, but sign in differently:

• MCP server: OAuth 2.1 + PKCE (S256) with Dynamic Client Registration, only. 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. The MCP server does not accept API keys, and MCP tool calls are live.
• REST API: bearer API key. For scripts, backends and pipelines. 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_... to https://api.stayingapi.com/v1.

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.

Security note: treat `stay_liv