# tripadvisor-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/chrischall/tripadvisor-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1560  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tripadvisor-mcp

## Description
TripAdvisor location search, details, photos, and reviews via the Terra API

## Tools
Capabilities this server exposes over MCP:

- **ta_search_locations** — Search TripAdvisor locations (restaurants, attractions, hotels) by name. Returns matches with a location id for the detail tools, plus pagination. Returns slim summaries by default; pass view:"full" for the whole records.
- **ta_search_nearby** — Find TripAdvisor locations near a point within a radius, or inside a bounding box. Center by lat+lon+radius, by a reference location_id+radius, or by a sw/ne bounding box. Returns matches with distance and a location id. Returns slim summaries by default; pass view:"full" for the whole records.
- **ta_get_locations** — Get details for MULTIPLE locations in one call (batch). Pass an array of location ids — cheaper than repeated ta_get_location_details. Unknown or unlicensed ids are silently omitted. Returns slim summaries by default; pass view:"full" for the whole records.
- **ta_get_location_details** — Get full details for a TripAdvisor location: names, descriptions, address, coordinates, traveler ratings, phone, category, and listing URLs. Rating-icon and other incidental image URLs are dropped by default; pass view:"full" for TripAdvisor's whole record.
- **ta_get_location_photos** — Get photos for a TripAdvisor location (multi-size image URLs, source, dimensions), with pagination.
- **ta_get_location_reviews** — Get traveler reviews for a TripAdvisor location, with pagination. Reviewer avatars and other image URLs are dropped by default; pass view:"full" for TripAdvisor's whole records.
- **ta_web_healthcheck** — Round-trips a small public www.tripadvisor.com URL (/) through ContextMint Bridge (your signed-in browser tab) and returns diagnostics: the bridge's role (host/peer/null), port, version, the extension link (linked / pair pending / not attached / never answered), the elapsed round-trip time, and a plain-English hint distinguishing 'bridge never came up' from 'extension not connected' from 'this browser can't serve a capability' from 'real www.tripadvisor.com-side problem'. Read-only, no auth required. Call this when a real tool fails and you want to know which hop broke.
- **ta_web_get_location** — Get a TripAdvisor location's core details (name, rating, review count, address, coordinates, phone, photo, listing URL) by location ID, read from the public page via the browser bridge. Works without an API key — use this when ta_get_location_details is unavailable or its key is blocked. Covers attractions, hotels, and restaurants. Does not return individual review text.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "tripadvisor-mcp": {
    "command": "npx",
    "args": ["-y","@chrischall/tripadvisor-mcp"],
    "env": {
      "TRIPADVISOR_API_KEY": "",
      "TRIPADVISOR_CACHE_TTL": "",
      "TRIPADVISOR_STATIC_CACHE_TTL": "",
      "TRIPADVISOR_REQUEST_TIMEOUT_MS": "",
      "TRIPADVISOR_DEBUG_LOG": ""
    }
  }
}
```

**Requires environment variables:** `TRIPADVISOR_API_KEY`, `TRIPADVISOR_CACHE_TTL`, `TRIPADVISOR_STATIC_CACHE_TTL`, `TRIPADVISOR_REQUEST_TIMEOUT_MS`, `TRIPADVISOR_DEBUG_LOG` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What tripadvisor-mcp does

tripadvisor-mcp exposes TripAdvisor data to MCP-compatible AI clients over stdio. Its Terra API tools cover hotels, restaurants, and attractions: agents can search by name, find locations near coordinates or within a bounding box, retrieve one or many location records, and request photos or traveler reviews. All Terra operations are read-only.

The server also includes an optional browser-based path. `ta_web_get_location` reads core information from a public TripAdvisor location page through a signed-in browser tab connected with ContextMint Bridge. This route can provide a location name, rating, review count, address, coordinates, phone number, primary photo, and listing URL without a Terra API key, but it does not return individual review text.

## How it works

The normal tools call the TripAdvisor Terra API using the `X-API-Key` header. Search results include location IDs that can be passed to the detail, photo, and review tools. `ta_get_locations` accepts multiple IDs in one request, which is intended to reduce repeated detail calls. Results can be returned as slim summaries or full records, and paginated tools expose additional pages.

The browser tools form a separate path from the Terra tools. `ta_web_healthcheck` makes a small request through the bridge and reports whether the bridge, extension, browser capability, or TripAdvisor site is responsible when a browser-backed request fails. The browser bridge is optional and is not used by the API-based tools.

## Setup and configuration

Run the package as an MCP stdio server with a client configuration such as:

```json
{
  "mcpServers": {
    "tripadvisor": {
      "command": "npx",
      "args": ["-y", "@chrischall/tripadvisor-mcp"],
      "env": {
        "TRIPADVISOR_API_KEY": "your-terra-api-key"
      }
    }
  }
}
```

Obtain a Terra key from TripAdvisor’s developer portal. A legacy Content API key is not suitable and returns HTTP 403. The Terra Discover tier is described as pay-as-you-go, with a 10 QPS limit and 10,000 calls per day. In-memory caching can reduce repeated requests.

`TRIPADVISOR_CACHE_TTL` controls search-response caching, while `TRIPADVISOR_STATIC_CACHE_TTL` controls caching for details, photos, and reviews. Set either to `0` to disable that cache. `TRIPADVISOR_REQUEST_TIMEOUT_MS` sets the optional bridge request timeout, and `TRIPADVISOR_DEBUG_LOG=1` logs browser-bridge requests to stderr.

To use the browser route, install the ContextMint Bridge Chrome extension, load it in Chrome with developer mode enabled, and approve the one-time pairing. Safari support is not available in the described setup.

## Tools and capabilities

- `ta_search_locations` searches by name and can return paginated slim or full matches.
- `ta_search_nearby` searches by coordinate and radius, reference location and radius, or southwest/northeast bounds.
- `ta_get_locations` retrieves details for multiple location IDs in one call.
- `ta_get_location_details` returns descriptions, addresses, coordinates, ratings, phone numbers, categories, and listing URLs.
- `ta_get_location_photos` returns paginated photos with source, dimensions, and multiple image sizes.
- `ta_get_location_reviews` returns paginated traveler reviews.
- `ta_web_healthcheck` diagnoses the optional browser-bridge route.
- `ta_web_get_location` retrieves core location data from a public TripAdvisor page without a Terra key.

## Limitations and notes

Terra access requires a valid API key, while the browser tools require the separately configured bridge. Unknown or unlicensed IDs passed to the batch detail tool are omitted silently. Default responses remove incidental image URLs such as rating icons and reviewer avatars; full-record views retain the broader TripAdvisor response. The browser-backed location tool does not provide review text.

_Full upstream README: https://allmcps.com/mcp/tripadvisor-mcp/readme_

