hotel-vacation-rental-mcp

<!-- mcp-name: com.stayingapi/hotel-vacation-rental-mcp -->

<p align="center">
  <a href="https://stayingapi.com">
    <img src="public/brand/logo-512.png" width="160" height="160" alt="StayingAPI" />
  </a>
</p>

<h1 align="center">Hotel &amp; Vacation Rental MCP - live prices, availability &amp; reviews across Booking.com, Airbnb, Vrbo &amp; Google Hotels</h1>

<p align="center">
  <b>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.</b><br/>
  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.
</p>

<p align="center">
  <a href="https://cursor.com/en/install-mcp?name=stayingapi&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGF5aW5nYXBpLmNvbS9tY3AifQ=="><img alt="Install in Cursor" src="https://img.shields.io/badge/Cursor-Install_MCP-000000?style=for-the-badge&logo=cursor&logoColor=white"/></a>
  <a href="https://stayingapi.com/signup"><img alt="300 free credits, no card" src="https://img.shields.io/badge/300_free_credits-no_card-16A34A?style=for-the-badge"/></a>
</p>

<p align="center">
  <a href="https://stayingapi.com"><img src="https://img.shields.io/badge/Website-stayingapi.com-0061FF?style=for-the-badge" alt="Website"/></a>
  <a href="https://stayingapi.com/docs/mcp"><img src="https://img.shields.io/badge/Docs-MCP_Guide-06B6D4?style=for-the-badge&logo=readthedocs&logoColor=white" alt="Docs"/></a>
  <a href="https://api.stayingapi.com/openapi.json"><img src="https://img.shields.io/badge/OpenAPI-Spec-85EA2D?style=for-the-badge&logo=openapiinitiative&logoColor=white" alt="OpenAPI"/></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-4CAF50?style=for-the-badge" alt="MIT License"/></a>
</p>

> **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](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.

---

## 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:**

```txt
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.

---

## Quick Install

> **Requirements:**
>
> - A StayingAPI account ([sign up](https://stayingapi.com/signup) - 300 free credits, no card)
> - **Either** OAuth (Claude, ChatGPT - no key handling at all) **or** an API key (`stay_live_...` / `stay_test_...`) from your dashboard

> **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)

<details>
<summary><b>Install in Claude (Desktop &amp; Web) - Recommended</b></summary>

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

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

</details>

<details>
<summary><b>Install in Claude Code (CLI)</b></summary>

OAuth (recommended):

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

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

Prefer a bearer key, or running headless?

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

</details>

<details>
<summary><b>Install in ChatGPT</b></summary>

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
```

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

</details>

<details>
<summary><b>Install in Cursor (One-Click or Manual)</b></summary>

**One-click:** use the [Install in Cursor](https://cursor.com/en/install-mcp?name=stayingapi&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGF5aW5nYXBpLmNvbS9tY3AifQ==) badge at the top of this README.

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

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

To use a bearer key instead of the OAuth flow, add a `headers` object with `"Authorization": "Bearer stay_live_YOUR_KEY_HERE"`.

</details>

<details>
<summary><b>Any other MCP client</b></summary>

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

- Clients that support OAuth 2.1 with Dynamic Client Registration authenticate automatically - nothing to configure.
- Clients that do not can present a bearer key instead: `Authorization: Bearer stay_live_...`.

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

</details>

---

## Authentication

Two ways in, both ending at the same account and the same credit balance:

- **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**.
- **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_...`.

**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_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.

---

## Available Tools

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

### 1. `search_stays`

Discover 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".

| Param | Type | Required | Notes |
| --- | --- | --- | --- |
| `location` | string | yes | Place name (`Split, HR`) or `lat,lng` |
| `checkIn` / `checkOut` | date | no | `YYYY-MM-DD`; required together; not in the past |
| `adults` / `children` / `childAges[]` / `rooms` | integer | no | `childAges[]` length must equal `children` |
| `propertyType[]` | enum[] | no | `hotel` \| `apartment` \| `house` \| `villa` \| `cottage` \| `other` |
| `amenities[]` | enum[] | no | Canonical amenity taxonomy |
| `minBedrooms` / `priceMin` / `priceMax` / `minGuestRating` | number | no | Filters applied post-normalization |
| `platforms[]` | enum[] | no | `airbnb` \| `booking` \| `vrbo` \| `google`; drives fan-out |
| `limit` / `cursor` / `sort` / `currency` | mixed | no | `limit` 1-40; `sort` = `recommended` \| `price_asc` \| `price_desc` \| `rating_desc` |

Response (trimmed):

```jsonc
{
  "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, "reviewCo