Overview

Airbnb MCP allows your application to search Airbnb listings and access detailed information. This allows users to perform customized searches based on parameters such as location, price, date, and number of people. By working in accordance with the MCP structure, your Kuika application can use Airbnb data directly through MCP.

Action Input (Input Parameters)

Parameters that can be used in Airbnb searches:

• location (String – Required)
  
  • The area to search.
  • E.g.: “Istanbul, Turkey”, “Greenwich”
• placeId (String – Optional)
  
  • This is the Google Maps Place ID information.
  • It can be found via Google Place ID Finder.
• pageCursor (String – Optional)
  
  • The pagination cursor. The first search may return many results; this parameter can be used to limit the results.
• checkIn (Date – Optional): Check-in date.
• checkout (Date – Optional): Check-out date.
• numberOfAdults (Integer – Default: 1)
• numberOfChildren (Integer – Default: 0)
• numberOfInfants (Integer – Default: 0)
• numberOfPets (Integer – Default: 0)
• minPrice (Decimal – Optional): Minimum price per night (EUR).
• maxPrice (Decimal – Optional): Maximum price per night (EUR).

Action Output

The Airbnb query returns the following information:

• paginationInfo: Each page has an ID, which can be used to limit the pages.
• searchResults: List of returned listings.
• searchUrl: URL output of the search performed.

1. Listing Details (under searchResults

Each listing contains the following information:

• avgRatingA11yLabel: Accessibility description of the average rating.
• Badges: Listing badges (Superhost, Guest Favorite, Rare Find, etc.).
• demandStayListing: High demand information for the listing.
• structuredContent: Structured listing description and features.
• Id: The unique identifier of the Airbnb listing.
• Url: The Airbnb link for the listing.
• listingParamOverrides: Parameter changes specific to this listing.
• structuredDisplayPrice: Price information.

2. demandStayListing Field

• Description: High demand message.
• name.localizedStringWithTranslationPreference: Message translated into the user's language.
• Id: Unique identifier of the message.
• Location: Relevant coordinate information.

3. structuredContent Field

• mapCategory: Map category (Superhost, Entire_Home, etc.).
• mapSecondaryLine: Additional description on the map.
• primaryLine: Main content displayed on the card.
• secondaryLine: Additional information on the card.

4. listingParamOverrides Field

• Adults: Number of adults.
• checkin / checkout: Valid check-in/check-out dates for the search.
• relaxedAmenityIds → Preferred but not required amenities (e.g., “kitchen,” “wifi”).
• splitStaysLocationPrecisions → If there are multiple locations, location precision (e.g., City, Neighborhood).
• splitStaysLocationsAcpIds → Airbnb City/Place IDs for separate locations.

5. structuredDisplayPrice Field

• primaryLine: Price displayed on the card (e.g., “€120 per night”).
• primaryLine.accessibilityLabel: Accessibility description of the price information (e.g., “120 Euro per night”).
• explanationData: Details of how the price is calculated.
  
  • Title: Descriptive text (e.g., “Price breakdown”).
  • priceDetails: Components of the price (e.g., nightly rate, cleaning fee, service fee).