# Airbnb (não oficial) — how to use (mcp.ai)

Search Airbnb stays straight from your AI agent. Give the city, the dates and how many guests, and get listings with total price for the period, discount, rating, reviews, location and photo, plus each listing's full description and photos. Filters by price range and property type. Hosted by the platform, no login and no credentials. Read-only public data: it does not book or message hosts. Not an official Airbnb service.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_airbnb?ms=1788601320000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `airbnb_buscar_hospedagens`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/airbnb`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/airbnb/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/airbnb/buscar/hospedagens` — Searches Airbnb stays by city or region and returns the listings with name, total price for the period (discounted when applicable), rating, review count, coordinates, badges such as 'Guest favorite' 
  - body: { location: string, country?: string, check_in?: string, check_out?: string, adults?: integer, children?: integer, infants?: integer, pets?: integer, price_min?: number, price_max?: number, room_types?: string[], currency?: string, cursor?: string }
- `POST https://api.mcp.ai/api/airbnb/detalhes/hospedagem` — Opens an Airbnb listing by id (the 'id' field of a search result) and returns the name, the host's full description, every photo, the city, coordinates, rating, review count, bedrooms, beds, bathrooms
  - body: { id: string, check_in?: string, check_out?: string, adults?: integer, currency?: string, ids?: string[] }

## Example prompts
- "Find apartments in Florianópolis for 2 people from Oct 10 to 13 under R$400 a night"
- "Compare stays in Gramado and Canela for a weekend and tell me which is cheaper"
- "Search entire homes in Búzios for 6 people during Carnival and open the details of the 3 best rated"

## More
- Page: https://mcp.ai/airbnb
- Agent spec (llms.txt): https://mcp.ai/airbnb/llms.txt
- Postman collection: https://mcp.ai/airbnb/postman.json