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
- 01Listing lookup by ID, URL or address
- 02Search by location, dates, price and capacity
- 03Photos, reviews, host and amenity details
- 04Pricing and 12-month availability
- 05REST API and hosted MCP access
Use cases
- 01Retrieve details for a known Airbnb listing
- 02Find stays matching trip dates and budget
- 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.
https://api.stayingapi.com/mcpclaude mcp add --transport http airbnb-skills https://api.stayingapi.com/mcp{"mcpServers":{"airbnb-skills":{"type":"http","url":"https://api.stayingapi.com/mcp"}}}Open in Cursor{"servers":{"airbnb-skills":{"type":"http","url":"https://api.stayingapi.com/mcp"}}}Open in VS Code{"mcpServers":{"airbnb-skills":{"type":"http","url":"https://api.stayingapi.com/mcp"}}}{"mcpServers":{"airbnb-skills":{"serverUrl":"https://api.stayingapi.com/mcp"}}}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 READMEairbnb-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
| Skill | Purpose | Cost |
|---|---|---|
airbnb-full | Complete toolkit — id/URL/address lookup, sub-resources, search, async batch jobs, webhooks, account/usage | 1 credit per record |
airbnb-stay | Single-listing lookup plus photos, reviews, host, amenities, availability, pricing, location, rating | 1 credit per call |
airbnb-search | Location / date / price / capacity search with superhost, instant-book, and luxury presets | 1 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
| Plan | Price | Credits | Rate limit |
|---|---|---|---|
| Free | $0 | 100 (one-time) | 20/min |
| Monthly | $5/mo | 400/month | 200/min |
| Annual | $54/yr | 5,000/year | 300/min |
| Enterprise | Custom | Custom | 1,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
- API reference: https://stayingapi.com/openapi.json
- Hosted MCP server: https://api.stayingapi.com/mcp
- Quickstart: https://stayingapi.com/quickstart/
- For AI agents: https://stayingapi.com/ai-agents/
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
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.