Airbnb MCP server for AI agents

Let Claude, ChatGPT or your own agent read Airbnb: 9 typed functions through one MCP server. No Airbnb API key needed.

Functions
9
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Airbnb

An MCP server for Airbnb alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/airbnb
Every site

One MCP server for Airbnb and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 9
  • bookListingReserve or book an Airbnb stay: returns the checkout link, never books or pays.

    Arguments

    NameTypeRequired
    args{ url?: string, id?: string, checkin: string, checkout: string, adults?: number, currency?: string }Yes

    Returns AirbnbCheckoutHandoff

    // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders.
    // Switch on `status`; a status you do not recognise means "show the person `url` and stop".
    interface AirbnbCheckoutHandoff {
      status: "ready_to_checkout" | "needs_login" | "unavailable";
      url: string;                       // the https page to open on the site
      urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page
      reason?: string;                   // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart
      detail?: string;                   // unavailable only: one sentence saying why
      account: { site: string; hint: string; signedInAs?: string };
      summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/bookListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.bookListing({
      id: "not-a-listing",
      checkin: { $daysFromNow: 60 },
      checkout: { $daysFromNow: 64 }
    });
  • getHostProfileA vacation rental host's public Airbnb profile (airbnb.com/users/show/<id>): name, about text, where they live, Superhost and identity-verified…

    Arguments

    NameTypeRequired
    args{ hostId?: string, url?: string, listing?: string }Yes

    Returns AirbnbHostProfile

    interface AirbnbHostListing {
      id: string;
      title: string | null;
      propertyType: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      bedrooms: number | null;
      beds: number | null;
      bathrooms: number | null;
      rating: number | null;
      reviewCount: number | null;
      isSuperhost: boolean;
      photoUrl: string | null;
      url: string;
    }
    
    interface AirbnbHostProfile {
      id: string;
      url: string;
      name: string | null;
      about: string | null;
      location: string | null;
      isSuperhost: boolean;
      isIdentityVerified: boolean;
      /** What the host has verified, e.g. ["Identity", "Email address"]. */
      verifications: string[];
      yearsHosting: number | null;
      monthsHosting: number | null;
      memberForYears: number | null;
      /** e.g. "Verified since January 2019". */
      verifiedSince: string | null;
      rating: number | null;
      reviewCount: number | null;
      languages: string | null;
      /** How many listings the host runs; 'listings' holds the first page of them. */
      listingCount: number | null;
      listings: AirbnbHostListing[];
      /** A few of the guest reviews the profile page shows, newest first. */
      recentReviews: Array<{ date: string | null; rating: number | null; text: string | null; reviewerName: string | null }>;
      profilePhotoUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/getHostProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.getHostProfile({ hostId: "57441707" });
  • getListingIs one Airbnb vacation rental available for given dates, and what does it cost per night: pass its /rooms/<id> url (or the id that search returns).

    Arguments

    NameTypeRequired
    args{ url?: string, id?: string, checkin?: string, checkout?: string, adults?: number, months?: number, currency?: string }Yes

    Returns AirbnbListingAvailability

    interface AirbnbCalendarDay {
      date: string;
      available: boolean;
      availableForCheckin: boolean;
      availableForCheckout: boolean;
      minNights: number | null;
      maxNights: number | null;
    }
    
    interface AirbnbQuote {
      total: string | null;
      originalTotal: string | null;
      qualifier: string | null;
      nights: number | null;
      nightlyRate: string | null;
      lines: Array<{ description: string; price: string | null }>;
    }
    
    interface AirbnbListingAvailability {
      id: string;
      url: string;
      currency: string;
      checkin: string | null;
      checkout: string | null;
      adults: number;
      available: boolean | null;
      unavailableReason: string | null;
      quote: AirbnbQuote | null;
      calendar: AirbnbCalendarDay[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.getListing({ id: "48491509", months: 1 });
  • getListingDetailsEverything the Airbnb listing page (airbnb.com/rooms/<id>) shows about one vacation rental or short-term stay, no dates needed: title, property type…

    Arguments

    NameTypeRequired
    args{ url?: string, id?: string }Yes

    Returns AirbnbListingDetails

    interface AirbnbAmenity {
      group: string | null;
      title: string;
      /** False for the "Not included" rows the site also lists. */
      available: boolean;
      note: string | null;
    }
    
    interface AirbnbListingDetails {
      id: string;
      url: string;
      title: string | null;
      /** The site's own headline, e.g. "Entire chalet in Mont-Tremblant, Canada". */
      propertyType: string | null;
      spaceType: string | null;
      description: string | null;
      guests: number | null;
      bedrooms: number | null;
      beds: number | null;
      bathrooms: number | null;
      rating: number | null;
      reviewCount: number | null;
      isGuestFavorite: boolean;
      categoryRatings: Array<{ category: string; rating: number | null }>;
      /** Share of reviews per star, e.g. { stars: 5, share: 0.83 }. */
      ratingDistribution: Array<{ stars: number; share: number }>;
      highlights: Array<{ headline: string; body: string | null }>;
      amenities: AirbnbAmenity[];
      sleeping: Array<{ room: string; beds: string[] }>;
      houseRules: Array<{ group: string; rule: string; detail: string | null }>;
      safety: string[];
      petsAllowed: boolean | null;
      location: {
        label: string | null;
        latitude: number | null;
        longitude: number | null;
        exact: boolean | null;
        breadcrumbs: Array<{ title: string; url: string }>;
        nearbyCities: Array<{ title: string; url: string }>;
      };
      host: {
        id: string | null;
        name: string | null;
        isSuperhost: boolean;
        isVerified: boolean;
        reviewCount: number | null;
        rating: number | null;
        yearsHosting: number | null;
        responseRate: string | null;
        responseTime: string | null;
        coHosts: string[];
      };
      photos: Array<{ url: string; caption: string | null; room: string | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/getListingDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.getListingDetails({ id: "48491509" });
  • getListingReviewsGuest reviews of one Airbnb vacation rental, read from the listing page's own reviews panel: each with star rating, date, full text, reviewer first…

    Arguments

    NameTypeRequired
    args{ url?: string, id?: string, sort?: "mostRecent" | "highestRated" | "lowestRated" | "bestQuality", limit?: number, offset?: number }Yes

    Returns AirbnbListingReviews

    interface AirbnbReview {
      id: string;
      rating: number | null;
      /** ISO timestamp the review was posted. */
      date: string | null;
      /** The site's own display date, e.g. "October 2026". */
      displayDate: string | null;
      text: string | null;
      language: string | null;
      reviewerName: string | null;
      reviewerLocation: string | null;
      /** e.g. "Stayed a few nights". */
      stayNote: string | null;
      hostResponse: string | null;
    }
    
    interface AirbnbListingReviews {
      id: string;
      url: string;
      sort: "mostRecent" | "highestRated" | "lowestRated" | "bestQuality";
      /** All reviews the listing has, not only this page. */
      totalCount: number | null;
      offset: number;
      reviews: AirbnbReview[];
      /** Pass as 'offset' for the next page; null when this was the last. */
      nextOffset: number | null;
      /** Guest-mentioned topics with counts, e.g. { tag: "Location", count: 124 }. */
      topics: Array<{ tag: string; count: number }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/getListingReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.getListingReviews({ id: "48491509", limit: 3 });
  • getPriceQuoteThe total price of staying at one Airbnb vacation rental for given dates, with every line the booking panel shows (nightly rate times nights…

    Arguments

    NameTypeRequired
    args{ url?: string, id?: string, checkin: string, checkout: string, adults?: number, currency?: string }Yes

    Returns AirbnbListingAvailability

    interface AirbnbCalendarDay {
      date: string;
      available: boolean;
      availableForCheckin: boolean;
      availableForCheckout: boolean;
      minNights: number | null;
      maxNights: number | null;
    }
    
    interface AirbnbQuote {
      total: string | null;
      originalTotal: string | null;
      qualifier: string | null;
      nights: number | null;
      nightlyRate: string | null;
      lines: Array<{ description: string; price: string | null }>;
    }
    
    interface AirbnbListingAvailability {
      id: string;
      url: string;
      currency: string;
      checkin: string | null;
      checkout: string | null;
      adults: number;
      available: boolean | null;
      unavailableReason: string | null;
      quote: AirbnbQuote | null;
      calendar: AirbnbCalendarDay[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/getPriceQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.getPriceQuote({
      id: "48491509",
      checkin: { $daysFromNow: 60 },
      checkout: { $daysFromNow: 64 },
      adults: 2
    });
  • listTripsThe signed-in guest's own trips from the Trips tab (airbnb.com/trips).

    Arguments

    NameTypeRequired
    args{ limit?: number }No

    Returns AirbnbTrips

    interface AirbnbTrip {
      id: string;                 // the site's global id
      internalId: string | null;  // the numeric id /trips/v1/<internalId> takes
      title: string | null;
      status: string;             // the site's own word: "UPCOMING" | "PAST" | "PENDING" | "CANCELED"
      cancelled: boolean;
      upcoming: boolean;
      startTime: string | null;   // ISO, as the site sends it
      endTime: string | null;
      imageUrl: string | null;
      url: string | null;         // the trip's own page
    }
    
    interface AirbnbTrips {
      trips: AirbnbTrip[];        // newest first; [] when the caller has none
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/listTrips

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.listTrips();
  • searchExperiencesTours, classes and things to do (Airbnb Experiences: guided walks, cooking classes, activities) for a city, from the place's own things-to-do page…

    Arguments

    NameTypeRequired
    args{ location: string }Yes

    Returns AirbnbExperience[]

    interface AirbnbExperience {
      id: string;
      title: string;
      category: string | null;
      city: string | null;
      description: string | null;
      rating: number | null;
      reviewCount: number | null;
      photoUrl: string | null;
      url: string;
      /** The landing page's own shelf, e.g. "Top-rated activities". */
      shelf: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/airbnb/searchExperiences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.airbnb.searchExperiences({ location: "Lisbon, Portugal" });

Use it from code