Tripadvisor MCP server for AI agents

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

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

Connect

Just Tripadvisor

An MCP server for Tripadvisor 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/tripadvisor
Every site

One MCP server for Tripadvisor 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 14
  • getAttractionReads one attraction in full: name, description, address, phone, website, opening hours, coordinates, rating, review count and Tripadvisor rank.

    Arguments

    NameTypeRequired
    idstringNo
    urlstringNo

    Returns TripadvisorAttractionDetail

    interface TripadvisorAttractionDetail {
      id: string;
      name: string;
      description?: string;
      rating?: number;
      reviewCount?: number;
      rank?: { position: number; outOf: number; category: string };
      address?: string;
      locality?: string;
      phone?: string;
      website?: string;
      openingHours?: string; // the site's own schema.org string, e.g. "Mo-Su 05:15-02:00"
      latitude?: number;
      longitude?: number;
      image?: string;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getAttraction

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getAttraction({ id: "103371" });
  • getDestinationReads a city or region's overview page (/Tourism-g<geoId>-…): its name, parent places, the site's review total, and the hotels, restaurants…

    Arguments

    NameTypeRequired
    args{ geoId?: string; url?: string }Yes

    Returns TripadvisorDestination

    interface TripadvisorDestinationListing {
      id: string;
      name: string;
      rating?: number;
      reviewCount?: number;
      // Restaurants only: the "$$ - $$$ • Cuisine, …" line under the name.
      detail?: string;
      url: string;
    }
    
    interface TripadvisorDestination {
      geoId: string;
      name: string;
      // Broader places, outermost first (the page's breadcrumb).
      parents: { geoId?: string; name: string; url?: string }[];
      // The site's own total, from "Tripadvisor has N reviews of …".
      reviewCount?: number;
      hotels: TripadvisorDestinationListing[];
      restaurants: TripadvisorDestinationListing[];
      attractions: TripadvisorDestinationListing[];
      tours: TripadvisorDestinationListing[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getDestination

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getDestination({ geoId: "35805" });
  • getHotelReads one hotel in full: name, address, phone, star class, rating and its sub-ratings, review count, rank in its city, amenities, room features…

    Arguments

    NameTypeRequired
    idstringNo
    urlstringNo

    Returns TripadvisorHotelDetail

    interface TripadvisorHotelDetail {
      id: string;
      name: string;
      rating?: number;
      reviewCount?: number;
      address?: string;
      phone?: string;
      latitude?: number;
      longitude?: number;
      url?: string;
      starClass?: number;
      subRatings?: Record<string, number>;
      amenities?: string[]; // the site's own labels, read the values off a result, never guess one from prose
      roomFeatures?: string[];
      nearbyPlaces?: Array<{ name: string; distance?: string }>;
      priceFrom?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getHotel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getHotel({ id: "224214" });
  • getHotelPricesReads the booking partners' live prices for one hotel for given check-in/check-out dates, guests and rooms.

    Arguments

    NameTypeRequired
    hotelIdstringYes
    checkInstring
    ISO date string YYYY-MM-DD.
    Yes
    checkOutstring
    ISO date string YYYY-MM-DD.
    Yes
    guestsnumber
    Number of guests, default 1.
    No
    roomsnumber
    Number of rooms, default 1.
    No

    Returns TripadvisorHotelPrices

    interface TripadvisorHotelPriceOffer {
      partner: string; // "Booking.com", "Expedia", etc.
      nightlyPrice?: number; // per-night price
      totalPrice?: number; // total for the stay
      bookingUrl?: string; // partner's booking link
    }
    
    interface TripadvisorHotelPrices {
      hotelId: string;
      offers: TripadvisorHotelPriceOffer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getHotelPrices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getHotelPrices({
      hotelId: "224214",
      checkIn: "2026-12-20",
      checkOut: "2026-12-22"
    });
  • getNearbyLists the hotels, restaurants or attractions near a listing (/HotelsNear-, /RestaurantsNear-, /AttractionsNear-g<geo>-d<loc>-).

    Arguments

    NameTypeRequired
    args{ kind: "hotels" | "restaurants" | "attractions"; url?: string; locationId?: string; geoId?: string }Yes

    Returns { locationId: string; geoId: string; kind: string; listings: TripadvisorNearbyListing[]; url: string }

    interface TripadvisorNearbyListing {
      id: string;
      name: string;
      rank?: number;
      rating?: number;
      reviewCount?: number;
      distance?: string;
      address?: string;
      sponsored?: boolean;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getNearby

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getNearby({
      kind: "restaurants",
      locationId: "103371",
      geoId: "60763"
    });
  • getPhotosLists a listing's photos, the gallery's albums (all photos, traveller, dining, rooms…) with their photo counts, and the first page of photos with…

    Arguments

    NameTypeRequired
    args{ locationId: string }Yes

    Returns { locationId: string; totalCount: number; albums: TripadvisorPhotoAlbum[]; photos: TripadvisorPhoto[] }

    // One photo album on a listing, "View all photos", "Traveler", "Dining", …
    interface TripadvisorPhotoAlbum {
      id: number;
      name: string;
      totalCount: number;
    }
    
    // One photo from a listing's media gallery. urlTemplate takes {width} and {height}.
    interface TripadvisorPhoto {
      id: string;
      caption?: string;
      url: string;
      width: number;
      height: number;
      urlTemplate?: string;
      album: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getPhotos({ locationId: "103371" });
  • getQuestionsReads a listing's travellers' Q&A questions, newest first.

    Arguments

    NameTypeRequired
    args{ locationId: string; offset?: number; limit?: number }Yes

    Returns { locationId: string; offset: number; questions: TripadvisorQuestion[]; hasMore: boolean }

    // One traveller question from a listing's Q&A.
    interface TripadvisorQuestion {
      id: string;
      text: string;
      language?: string;
      answerCount: number;
      submitted?: string;
      // The asker's opaque member id, not the /Profile handle.
      memberId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getQuestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getQuestions({ locationId: "103371" });
  • getRestaurantReads one restaurant in full: name, address, phone, cuisines, price range, opening hours, rating, review count and Tripadvisor rank.

    Arguments

    NameTypeRequired
    idstringNo
    urlstringNo

    Returns TripadvisorRestaurantDetail

    interface TripadvisorRestaurantDetail {
      id: string;
      name: string;
      rating?: number;
      reviewCount?: number;
      rank?: { position: number; outOf: number; category: string };
      address?: string;
      phone?: string;
      latitude?: number;
      longitude?: number;
      url?: string;
      cuisines?: string[];
      priceRange?: string;
      openingHours?: Array<{ dayOfWeek: string; opens: string; closes: string }>;
      // menuUrl and food/service/value/atmosphere sub-ratings are not yet extracted,
      // see index.ts's getRestaurant comment for why
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getRestaurant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getRestaurant({ id: "3159643" });
  • getReviewReads one review on its own page.

    Arguments

    NameTypeRequired
    args{ url?: string; id?: string; locationId?: string; geoId?: string }Yes

    Returns TripadvisorReviewDetail

    interface TripadvisorReview {
      id: string;
      rating?: number;
      title?: string;
      text?: string;
      visitDate?: string;
      tripType?: string;
      writtenDate?: string;
      author?: { handle: string; name?: string };
      helpfulVotes?: number;
      subRatings?: Array<{ name: string; rating: number }>;
      url: string;
    }
    
    // One review read off its own page, with the owner's response when there is one.
    interface TripadvisorReviewDetail extends TripadvisorReview {
      locationId: string;
      geoId?: string;
      listing?: { name: string; url?: string };
      response?: { author?: string; date?: string; text: string };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getReview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getReview({});
  • getReviewsReads one page of a hotel's, restaurant's or attraction's reviews in the site's own order.

    Arguments

    NameTypeRequired
    idstringNo
    type"hotel" | "restaurant" | "attraction"No
    urlstringNo
    offsetnumberNo

    Returns TripadvisorReviews

    interface TripadvisorReview {
      id: string;
      rating?: number;
      title?: string;
      text?: string;
      visitDate?: string;
      tripType?: string;
      writtenDate?: string;
      author?: { handle: string; name?: string };
      helpfulVotes?: number;
      subRatings?: Array<{ name: string; rating: number }>;
      url: string;
    }
    
    interface TripadvisorReviews {
      locationId: string;
      geoId?: string;
      offset: number;
      reviews: TripadvisorReview[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/getReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.getReviews({ id: "3159643", type: "restaurant" });
  • searchAttractionsLists the things to do in a city or region in Tripadvisor's ranking.

    Arguments

    NameTypeRequired
    geoIdstringYes
    categoryIdstring
    The c<id> in /Attractions-g<geo>-Activities-c<id>-….
    No
    offsetnumberNo

    Returns SearchAttractionsResult

    interface TripadvisorAttraction {
      id: string;
      name: string;
      rank?: number;
      rating?: number;
      reviewCount?: number;
      categories?: string[];
      neighborhood?: string;
      description?: string;
      url: string;
    }
    
    interface SearchAttractionsResult {
      attractions: TripadvisorAttraction[];
      offset: number;
      hasMore: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/searchAttractions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.searchAttractions({ geoId: "60763" });
  • searchHotelsLists the hotels in a city or region, in Tripadvisor's own ranking, with each hotel's id, name, rating, review count, address, coordinates and 'from'…

    Arguments

    NameTypeRequired
    geoIdstringYes
    offsetnumberNo

    Returns SearchHotelsResult

    interface TripadvisorHotel {
      id: string;
      name: string;
      rating?: number;
      reviewCount?: number;
      address?: string;
      latitude?: number;
      longitude?: number;
      priceFrom?: number;
      url?: string;
    }
    
    interface SearchHotelsResult {
      hotels: TripadvisorHotel[];
      offset: number;
      hasMore: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/searchHotels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.searchHotels({ geoId: "60763" });
  • searchRestaurantsLists the restaurants in a city or region in Tripadvisor's ranking, with id, name, rating, review count, cuisines, price level and url, filterable by…

    Arguments

    NameTypeRequired
    geoIdstringYes
    offsetnumberNo

    Returns SearchRestaurantsResult

    interface TripadvisorRestaurant {
      id: string;
      name: string;
      rating?: number;
      reviewCount?: number;
      address?: string;
      latitude?: number;
      longitude?: number;
      cuisines?: string[];
      priceLevel?: string;
      url?: string;
    }
    
    interface SearchRestaurantsResult {
      restaurants: TripadvisorRestaurant[];
      offset: number;
      hasMore: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tripadvisor/searchRestaurants

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tripadvisor.searchRestaurants({ geoId: "35805" });

Use it from code