Staying API — Airbnb Stay Data MCP Server
Real-time Airbnb listing data — photos, reviews, host, pricing & 12-month availability for AI agents. Free tier, no card.
Documentation
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
| 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.