airbnb-stay

Focused single-listing skill. Use when the user explicitly asks about one known Airbnb property — its details, price, reviews, availability, photos, or host — given a listing id, an airbnb.com/rooms/... URL, or a street address.

When to use this skill

DO use when the user asks:

• "What's this place? https://www.airbnb.com/rooms/12345678"
• "How much per night is listing 12345678?"
• "What are the reviews like on this Airbnb?"
• "Is this place available in July?"
• "Who's the host / is it a superhost?"
• "Show me the photos for this listing."

Do NOT use when:

• An Airbnb link or address appears incidentally in context (email signatures, unrelated documents)
• The user wants to find listings by criteria — use airbnb-search instead
• The user has not signaled they want a property lookup

If you also need batch resolution, search, or webhooks, use airbnb-full — it bundles everything in one install.

Tools

Every tool returns a Python dict — the API response on success, or {"error": ..., "detail": ...} on failure. Sub-resource tools accept stay_id (cheapest), url, or address.

lookup_stay_by_id(stay_id, fields=None) — 1 credit

Full canonical Stay record: title, property/room type, capacity, star rating, location, host, pricing, reviews count, rating breakdown, photos, reviews, amenities, and availability. fields is an optional comma-separated projection.

lookup_stay_by_url(url, fields=None) — 1 credit

Same record, resolved from an airbnb.com/rooms/<id> URL.

lookup_stay_by_address(address, fields=None) — 3 credits

Resolve a listing from a street address. Weighted higher; prefer id or URL when you have one.

get_stay_photos(...) — 1 credit

Photo gallery (responsive image URLs).

get_stay_reviews(...) — 1 credit

Reviews plus the rating breakdown (cleanliness, accuracy, check-in, communication, location, value).

get_stay_host(...) — 1 credit

Host profile (name, superhost status, response data).

get_stay_amenities(...) — 1 credit

Amenities grouped by category.

get_stay_availability(...) — 1 credit

Per-date availability calendar (up to 12 months).

get_stay_pricing(...) — 1 credit

Pricing block: nightly rate, fees, currency.

get_stay_location(...) — 1 credit

Coordinates and address.

get_stay_rating(...) — 1 credit

Star rating and review-count summary.

Equivalent MCP tools

The Staying API hosts a streamable-HTTP MCP server at https://api.stayingapi.com/mcp. If your agent speaks MCP, you can skip this skill and call: lookup_stay_by_id, lookup_stay_by_url, get_stay_photos, get_stay_reviews.

Authentication

Set STAYINGAPI_KEY to your Staying API key (format sk_...).

export STAYINGAPI_KEY="sk_..."

Get a free key with 100 credits at https://stayingapi.com/app/keys — no card required.

Pricing

One credit per successful call (by-address is 3). Failed calls (4xx/5xx) do not consume credits. Credits roll forward and don't expire.

Errors

Functions return a dict. On failure it carries an error key:

• {"error": "auth", ...} — STAYINGAPI_KEY is missing or invalid
• {"error": "HTTP 404", ...} — listing not found
• {"error": "HTTP 429", ...} — rate-limited; back off and retry
• {"error": "network", ...} — DNS/connection failure

API reference

• OpenAPI spec: https://stayingapi.com/openapi.json
• Hosted MCP server: https://api.stayingapi.com/mcp
• Quickstart: https://stayingapi.com/quickstart/

Trademark

Staying API is an independent service and is not affiliated with, endorsed by, or sponsored by Airbnb, Inc. "Airbnb" is a registered trademark of Airbnb, Inc.