mcpField
S
Staying Api — Airbnb Stay Data

Staying Api — Airbnb Stay Data

Remote
github.com/nikhonitData & Analytics0Updated 18w ago
Repository

About Staying Api — Airbnb Stay Data

airbnb-skills provides agent skills for looking up and searching Airbnb stay data through the Staying API. It covers listing details and location-based searches, with a typed Stay contract and access through REST or a hosted MCP server.

Key features

  1. 01Listing lookup by ID, URL or address
  2. 02Search by location, dates, price and capacity
  3. 03Photos, reviews, host and amenity details
  4. 04Pricing and 12-month availability
  5. 05REST API and hosted MCP access

Use cases

  1. 01Retrieve details for a known Airbnb listing
  2. 02Find stays matching trip dates and budget
  3. 03Compare hosts, amenities, reviews and availability

MCP support

The Staying API hosts a Streamable HTTP MCP server with five tools for listing lookup, search, photos and reviews. Clients authenticate with a Bearer key or OAuth 2.1 PKCE.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://api.stayingapi.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

airbnb-skills

Agent skills for Airbnb stay data. Three drop-in skills that let any agent look up and search Airbnb listings — photos, reviews, host, pricing, and 12-month availability — over the Staying API. One typed Stay contract that doesn't break when Airbnb reworks their site, available as REST and MCP.

Free to use — grab a key (100 credits, no card required) and you're calling Airbnb stay data from Claude, ChatGPT, Cursor, or your own agent loop in under two minutes.

Pure Python standard library. No dependencies. MIT-0 licensed.

Install

# OpenClaw (via ClawHub)
npx clawhub@latest install airbnb-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/airbnb-skills/skills/airbnb-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/airbnb-skills

Skills in this repo

SkillPurposeCost
airbnb-fullComplete toolkit — id/URL/address lookup, sub-resources, search, async batch jobs, webhooks, account/usage1 credit per record
airbnb-staySingle-listing lookup plus photos, reviews, host, amenities, availability, pricing, location, rating1 credit per call
airbnb-searchLocation / date / price / capacity search with superhost, instant-book, and luxury presets1 credit per result

Install the bundled airbnb-full for agents that need broad coverage. Install the focused variants when you want minimum tool surface.

Authentication

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

export STAYINGAPI_KEY="sk_..."

Get a free key in 30 seconds — 100 credits, no card required. The same key works for these skills, the hosted MCP server, and direct REST calls.

Use over MCP instead

The Staying API hosts a streamable-HTTP MCP server, so MCP-native agents can skip the scripts entirely. Point your client at https://api.stayingapi.com/mcp with an Authorization: Bearer sk_... header (or OAuth 2.1 PKCE, scope mcp:access) to get five tools: lookup_stay_by_id, lookup_stay_by_url, search_stays, get_stay_photos, get_stay_reviews. Server card: https://stayingapi.com/.well-known/mcp/server-card.json.

Pricing

PlanPriceCreditsRate limit
Free$0100 (one-time)20/min
Monthly$5/mo400/month200/min
Annual$54/yr5,000/year300/min
EnterpriseCustomCustom1,500/min

One credit equals one stay record returned (search bills per result; by-address weighs 3). Failed calls do not consume credits. Credits roll forward and don't expire.

Source

Issues and contributions

See CONTRIBUTING.md. Security reports: SECURITY.md.

License

MIT No Attribution. Fork, ship, sublicense — no attribution required.

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.