{
  "markdown": "# tripadvisor-mcp\n\n[![npm](https://img.shields.io/npm/v/@chrischall/tripadvisor-mcp)](https://www.npmjs.com/package/@chrischall/tripadvisor-mcp)\n\nMCP 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.)\n\n> Developed and maintained by AI (Claude Code). Use at your own discretion.\n\n## Quick start\n\n```json\n{\n  \"mcpServers\": {\n    \"tripadvisor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@chrischall/tripadvisor-mcp\"],\n      \"env\": { \"TRIPADVISOR_API_KEY\": \"your-terra-api-key-here\" }\n    }\n  }\n}\n```\n\nGet a key at [tripadvisor.com/developers](https://www.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.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `ta_search_locations` | Search locations by name (optionally scoped by category, country/geo/postal code) — paginated; `compact:true` for slim summaries |\n| `ta_search_nearby` | Find locations near a lat/lon+radius, a `location_id`+radius, or inside a sw/ne bounding box (category, min rating, sort) — `compact:true` supported |\n| `ta_get_location_details` | Full details: names, descriptions, address, coordinates, traveler ratings, phone, listing URLs |\n| `ta_get_locations` | Batch — details for **multiple** location ids in one call (cheaper than N detail calls); `compact:true` supported |\n| `ta_get_location_photos` | Photos with multi-size image URLs, source, and dimensions — paginated |\n| `ta_get_location_reviews` | Traveler reviews — paginated |\n| `ta_web_healthcheck` | Diagnose the optional tripadvisor.com browser-bridge connection (see below) |\n| `ta_web_get_location` | Location details (rating, address, coords, phone, photo) read from the public page via the browser bridge — **no API key needed** |\n\nAll tools are read-only — Terra has no write endpoints.\n\n### Browser bridge (optional)\n\n`ta_web_healthcheck` is the first tool of an optional second tier that reaches\ntripadvisor.com's consumer site (bot-walled, so unreachable server-side) by\nrouting same-origin fetches through your signed-in browser tab via the\n[fetchproxy](https://github.com/chrischall/fetchproxy) Transporter extension.\nIt needs the extension installed and a one-time pairing approval; the Content\nAPI tools above never touch the bridge.\n\n`ta_web_get_location` uses this bridge to read a location's details straight\nfrom its public TripAdvisor page — so it works **without an API key**,\ncovering attractions, hotels, and restaurants. It returns core business data\n(rating, review count, address, coordinates, phone, primary photo, listing\nURL) but not individual review text. Request shapes are pinned in\n[docs/TRIPADVISOR-WEB-API.md](docs/TRIPADVISOR-WEB-API.md).\n\n## Environment\n\n| Var | Required | Purpose |\n| --- | --- | --- |\n| `TRIPADVISOR_API_KEY` | yes | Terra API key, sent as the `X-API-Key` header. |\n| `TRIPADVISOR_CACHE_TTL` | no | Seconds to cache search responses (default: 300; `0` disables). |\n| `TRIPADVISOR_STATIC_CACHE_TTL` | no | Seconds to cache details/photos/reviews (default: 3600; `0` disables). |\n| `TRIPADVISOR_REQUEST_TIMEOUT_MS` | no | Per-request timeout for the optional browser bridge (default: 30000). |\n| `TRIPADVISOR_DEBUG_LOG` | no | Set to `1` to log browser-bridge requests to stderr. |\n\n## Development\n\n```bash\nnpm install\nnpm run build   # tsc + esbuild bundle\nnpm test        # vitest (no real network)\n```\n\nEndpoint request shapes are pinned in [docs/TRIPADVISOR-API.md](docs/TRIPADVISOR-API.md). With a key in `.env`, `node scripts/live-probe.mjs` exercises every read path through the built client.\n\n## License\n\nMIT\n",
  "bytes": 3914,
  "sha": "91030badc30fd9d4b14b6ccd97af94ba4f0c8f326a872073cc4804774a644986",
  "repo_slug": "chrischall/tripadvisor-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_chrischall_tripadvisor_mcp_0d6dae3e/readme"
}