Tripadvisor MCP logo

Tripadvisor MCP

Read-only TripAdvisor search, location details, photos, and reviews through Terra API and an optional browser bridge.

Install Tripadvisor MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tripadvisor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/tripadvisor-mcp"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "YOUR_VALUE_HERE",
        "TRIPADVISOR_CACHE_TTL": "YOUR_VALUE_HERE",
        "TRIPADVISOR_STATIC_CACHE_TTL": "YOUR_VALUE_HERE",
        "TRIPADVISOR_REQUEST_TIMEOUT_MS": "YOUR_VALUE_HERE",
        "TRIPADVISOR_DEBUG_LOG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

tripadvisor-mcp connects AI clients to TripAdvisor travel data through the Terra API, with read-only tools for searching locations, retrieving details, photos, and reviews. It supports name searches, nearby and bounding-box searches, pagination, slim or full response views, and batched location lookups. An optional ContextMint Bridge path reads core details from public TripAdvisor pages without an API key. Use it for travel research involving hotels, restaurants, and attractions.

Use cases

  • Search for hotels, restaurants, or attractions by name
  • Find TripAdvisor locations near coordinates or inside a bounding box
  • Retrieve photos and traveler reviews for a location
  • Batch-load details for multiple TripAdvisor location IDs
  • Fall back to public-page location data when Terra access is unavailable

Key features

  • TripAdvisor Terra API access over MCP stdio
  • Name, radius, coordinate, and bounding-box searches
  • Batch location detail retrieval
  • Paginated photos and traveler reviews
  • Optional browser-bridge fallback without an API key
  • Configurable in-memory caching and request diagnostics

Tools8

What Tripadvisor MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

13/13 checks healthy over the last 64d

What it can do

From the 8 tools this server returned when we ran it; 8 declare their own safety hints.

Handles credentials · 1Makes network requests · 8Read-only tools · 8
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age108 days
Maintainers1

Observed 2026-10-21 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @chrischall/tripadvisor-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads2.1kPackage downloads in the last 30 days.
Last commit8d agoMost recent push to the default branch.
Tools exposed8Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Tripadvisor MCP works

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:

config.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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tripadvisor MCP

tripadvisor-mcp is an MCP server that connects AI clients to TripAdvisor’s Terra API and, optionally, public TripAdvisor pages through a browser bridge. Its main tools search locations, find nearby places, retrieve details in batches, and fetch photos or traveler reviews, with browser-backed core details available without a Terra API key.

Install it through an MCP client using `npx -y @chrischall/tripadvisor-mcp` and provide `TRIPADVISOR_API_KEY` for Terra tools. Configure the command and environment in the client’s MCP server settings.

Yes, `ta_web_get_location` works without a Terra API key when the ContextMint Bridge browser extension is installed, paired, and connected to Chrome. It returns core location data but not individual review text.

Call `ta_web_healthcheck` to identify the failing hop. It reports bridge and extension status, round-trip timing, and a plain-language hint for bridge startup, pairing, browser capability, or TripAdvisor-side problems.

Yes, use `ta_get_locations` with an array of location IDs. It batches detail retrieval and is intended to cost less than making repeated individual detail requests.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTripadvisor MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tripadvisor-mcp?style=directory)](https://allmcps.com/mcp/tripadvisor-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/tripadvisor-mcp"><img src="https://allmcps.com/api/badge/tripadvisor-mcp?style=directory" alt="Tripadvisor MCP on AllMCPs" /></a>