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.
- Site
- tripadvisor.com
- Functions
- 14
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/tripadvisorOne MCP server for Tripadvisor and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
getAttractionReads one attraction in full: name, description, address, phone, website, opening hours, coordinates, rating, review count and Tripadvisor rank.Arguments
Name Type Required idstringNo urlstringNo Returns
TripadvisorAttractionDetailinterface 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/getAttractionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getAttraction({ id: "103371" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getAttraction({"id": "103371"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getAttraction \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"103371"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ geoId?: string; url?: string }Yes Returns
TripadvisorDestinationinterface 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/getDestinationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getDestination({ geoId: "35805" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getDestination({"geoId": "35805"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getDestination \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"35805"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringNo urlstringNo Returns
TripadvisorHotelDetailinterface 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/getHotelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getHotel({ id: "224214" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getHotel({"id": "224214"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getHotel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"224214"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hotelIdstringYes checkInstringISO date string YYYY-MM-DD.Yes checkOutstringISO date string YYYY-MM-DD.Yes guestsnumberNumber of guests, default 1.No roomsnumberNumber of rooms, default 1.No Returns
TripadvisorHotelPricesinterface 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/getHotelPricesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getHotelPrices({ hotelId: "224214", checkIn: "2026-12-20", checkOut: "2026-12-22" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getHotelPrices({ "hotelId": "224214", "checkIn": "2026-12-20", "checkOut": "2026-12-22" }))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getHotelPrices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"hotelId":"224214","checkIn":"2026-12-20","checkOut":"2026-12-22"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getNearbyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getNearby({ kind: "restaurants", locationId: "103371", geoId: "60763" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getNearby({ "kind": "restaurants", "locationId": "103371", "geoId": "60763" }))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getNearby \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"kind":"restaurants","locationId":"103371","geoId":"60763"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getPhotos({ locationId: "103371" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getPhotos({"locationId": "103371"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"locationId":"103371"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tripadvisor.getPhotos({ locationId: "103371" });getQuestionsReads a listing's travellers' Q&A questions, newest first.Arguments
Name Type Required 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/getQuestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getQuestions({ locationId: "103371" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getQuestions({"locationId": "103371"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getQuestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"locationId":"103371"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringNo urlstringNo Returns
TripadvisorRestaurantDetailinterface 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/getRestaurantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getRestaurant({ id: "3159643" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getRestaurant({"id": "3159643"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getRestaurant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"3159643"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tripadvisor.getRestaurant({ id: "3159643" });getReviewReads one review on its own page.Arguments
Name Type Required args{ url?: string; id?: string; locationId?: string; geoId?: string }Yes Returns
TripadvisorReviewDetailinterface 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/getReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getReview({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getReview({}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringNo type"hotel" | "restaurant" | "attraction"No urlstringNo offsetnumberNo Returns
TripadvisorReviewsinterface 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/getReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.getReviews({ id: "3159643", type: "restaurant" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.getReviews({"id": "3159643", "type": "restaurant"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/getReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"3159643","type":"restaurant"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tripadvisor.getReviews({ id: "3159643", type: "restaurant" });searchFinds places by words, a city or region, a hotel, restaurant, attraction, tour or airline, through the site's own search-as-you-type box, returning…Arguments
Name Type Required querystringYes Returns
SearchResultinterface TripadvisorLocation { id: string; placeType: "CITY" | "STATE" | "COUNTRY" | "ACCOMMODATION" | "ATTRACTION" | "EATERY" | "AIRLINE" | "ACTIVITY" | "LOCATION" | string; localizedName: string; webLinkUrl?: string; parentPlace?: { id?: string; localizedName?: string }[]; } interface SearchResult { results: TripadvisorLocation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tripadvisor/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.search("Chicago");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.search("Chicago"))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"Chicago"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tripadvisor.search("Chicago");searchAttractionsLists the things to do in a city or region in Tripadvisor's ranking.Arguments
Name Type Required geoIdstringYes categoryIdstringThe c<id> in /Attractions-g<geo>-Activities-c<id>-….No offsetnumberNo Returns
SearchAttractionsResultinterface 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/searchAttractionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.searchAttractions({ geoId: "60763" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.searchAttractions({"geoId": "60763"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/searchAttractions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"60763"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required geoIdstringYes offsetnumberNo Returns
SearchHotelsResultinterface 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/searchHotelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.searchHotels({ geoId: "60763" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.searchHotels({"geoId": "60763"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/searchHotels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"60763"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required geoIdstringYes offsetnumberNo Returns
SearchRestaurantsResultinterface 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/searchRestaurantsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tripadvisor.searchRestaurants({ geoId: "35805" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tripadvisor.searchRestaurants({"geoId": "35805"}))curl -X POST https://api.bowmark.ai/v1/sites/tripadvisor/searchRestaurants \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"35805"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tripadvisor.searchRestaurants({ geoId: "35805" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/tripadvisor/<function> - OpenAPI
/v1/sites/tripadvisor/openapi.json