Back to Browse

Tripadvisor MCP Server

Developer ToolsModerate6.6Local
Free

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

About

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

Security Report

6.6
Moderate6.6Moderate Risk

This is a well-structured TripAdvisor API MCP server with proper authentication, secure credential handling, and appropriate input validation. The codebase demonstrates good security practices including key-safe header-based authentication, comprehensive error handling without credential leakage, and thoughtful caching to respect API quotas. No critical vulnerabilities were identified; minor observations about error message specificity and test coverage are low-severity. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

7 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

What You'll Need

Set these up before or after installing:

Your TripAdvisor Terra API key (tripadvisor.com/developers)Required

Environment variable: TRIPADVISOR_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-chrischall-tripadvisor-mcp": {
      "env": {
        "TRIPADVISOR_API_KEY": "your-tripadvisor-api-key-here"
      },
      "args": [
        "-y",
        "@chrischall/tripadvisor-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

tripadvisor-mcp

npm

MCP server for the TripAdvisor Terra API — travel data for Claude. Search hotels, restaurants, and attractions by name or coordinates, then pull full details, photos, and reviews, all over stdio. (Terra is TripAdvisor's current API; the legacy Content API is sunset on 2026-08-31.)

Developed and maintained by AI (Claude Code). Use at your own discretion.

Quick start

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

Get a key at tripadvisor.com/developers. The free Discover tier is pay-as-you-go (10 QPS, 10,000 calls/day); responses are cached in-memory to stretch it. Make sure it's a Terra key — a legacy Content API key returns 403.

Tools

ToolWhat it does
ta_search_locationsSearch locations by name (optionally scoped by category, country/geo/postal code) — paginated; compact:true for slim summaries
ta_search_nearbyFind locations near a lat/lon+radius, a location_id+radius, or inside a sw/ne bounding box (category, min rating, sort) — compact:true supported
ta_get_location_detailsFull details: names, descriptions, address, coordinates, traveler ratings, phone, listing URLs
ta_get_locationsBatch — details for multiple location ids in one call (cheaper than N detail calls); compact:true supported
ta_get_location_photosPhotos with multi-size image URLs, source, and dimensions — paginated
ta_get_location_reviewsTraveler reviews — paginated
ta_web_healthcheckDiagnose the optional tripadvisor.com browser-bridge connection (see below)
ta_web_get_locationLocation details (rating, address, coords, phone, photo) read from the public page via the browser bridge — no API key needed

All tools are read-only — Terra has no write endpoints.

Browser bridge (optional)

ta_web_healthcheck is the first tool of an optional second tier that reaches tripadvisor.com's consumer site (bot-walled, so unreachable server-side) by routing same-origin fetches through your signed-in browser tab via the ContextMint Bridge browser extension, installed from its releases page (Chrome: download the chrome zip and load it unpacked from chrome://extensions with Developer mode on; Safari isn't available yet — it will ship inside the ContextMint app, which has no public download — so use Chrome for now). It needs the extension installed and a one-time pairing approval; the Content API tools above never touch the bridge.

ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer — fetchproxy's own README (https://github.com/chrischall/fetchproxy#extension) points to it. Its source is public at https://github.com/nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).

ta_web_get_location uses this bridge to read a location's details straight from its public TripAdvisor page — so it works without an API key, covering attractions, hotels, and restaurants. It returns core business data (rating, review count, address, coordinates, phone, primary photo, listing URL) but not individual review text. Request shapes are pinned in docs/TRIPADVISOR-WEB-API.md.

Environment

VarRequiredPurpose
TRIPADVISOR_API_KEYyesTerra API key, sent as the X-API-Key header.
TRIPADVISOR_CACHE_TTLnoSeconds to cache search responses (default: 300; 0 disables).
TRIPADVISOR_STATIC_CACHE_TTLnoSeconds to cache details/photos/reviews (default: 3600; 0 disables).
TRIPADVISOR_REQUEST_TIMEOUT_MSnoPer-request timeout for the optional browser bridge (default: 30000).
TRIPADVISOR_DEBUG_LOGnoSet to 1 to log browser-bridge requests to stderr.

Development

npm install
npm run build   # tsc + esbuild bundle
npm test        # vitest (no real network)

Endpoint request shapes are pinned in docs/TRIPADVISOR-API.md. With a key in .env, node scripts/live-probe.mjs exercises every read path through the built client.

License

MIT

Reviews

No reviews yet

Be the first to review this server!