For AI agents
Staying API is designed to be used by AI agents as a first-class consumer.
MCP server
The Model Context Protocol server lives at https://api.stayingapi.com/mcp.
It speaks the 2025-06-18 MCP spec and exposes 5 tools:
| Tool | Purpose | Cost |
|---|---|---|
lookup_stay_by_id | Get a stay by Airbnb id. | 1 credit |
lookup_stay_by_url | Get a stay by airbnb.com/rooms/… URL. | 1 credit |
search_stays | Search by location, dates + filters (maxItems ≤ 250). | 1 credit per result |
get_stay_photos | Photos array for a listing. | 1 credit |
get_stay_reviews | Reviews + rating breakdown for a listing. | 1 credit |
Authenticate with Authorization: Bearer sk_... or connect via OAuth 2.1 —
on claude.ai (or Claude Desktop) go to Settings → Connectors → Add custom
connector and paste the server URL; the consent flow issues a key scoped
mcp:access automatically. Setup instructions for Claude Desktop, Claude
Code, Cursor, ChatGPT, and the OpenAI Agents SDK are in the
dashboard.
Discovery
We publish RFC 8288 link relations on every page, so an agent that GETs the homepage finds:
<rel="service-desc">→ /openapi.json<rel="service-doc">→ /quickstart/<rel="mcp-server">→https://api.stayingapi.com/mcp<rel="mcp-server-card">→ /.well-known/mcp/server-card.json<rel="agent-skills">→ /.well-known/agent-skills/index.json<rel="oauth-protected-resource">→ metadata for OAuth handshake.
llms.txt and llms-full.txt
- llms.txt — short, structured summary.
- llms-full.txt — every docs page concatenated for LLM context windows.
OpenAPI 3.1
openapi.json covers every route with full schema components, security schemes, and examples. Compatible with every codegen tool (Stainless, openapi-typescript, Swagger UI).
WebMCP
If you load https://stayingapi.com/ in a Chromium-based agent, the page exposes
navigator.modelContext tools for navigate_to, open_signup, open_pricing,
and open_mcp_setup. See webmcp.js.