@chrischall/tripadvisor-mcp 0.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "tripadvisor-mcp",
+  "owner": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "metadata": {
+    "description": "MCP server for the TripAdvisor Content API — location search, details, photos, and reviews",
+    "version": "0.0.0"
+  },
+  "plugins": [
+    {
+      "name": "tripadvisor-mcp",
+      "displayName": "TripAdvisor",
+      "source": "./",
+      "description": "TripAdvisor travel data via the official Content API — search hotels, restaurants, and attractions, with details, photos, and reviews",
+      "version": "0.0.0",
+      "author": {
+        "name": "Chris Hall"
+      },
+      "homepage": "https://github.com/chrischall/tripadvisor-mcp",
+      "repository": "https://github.com/chrischall/tripadvisor-mcp",
+      "license": "MIT",
+      "keywords": [
+        "tripadvisor",
+        "travel",
+        "hotels",
+        "restaurants",
+        "attractions",
+        "reviews",
+        "mcp"
+      ],
+      "category": "data"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "tripadvisor-mcp",
+  "displayName": "TripAdvisor",
+  "version": "0.0.0",
+  "description": "MCP server for the TripAdvisor Content API — location search, details, photos, and reviews",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "homepage": "https://github.com/chrischall/tripadvisor-mcp",
+  "repository": "https://github.com/chrischall/tripadvisor-mcp",
+  "license": "MIT",
+  "keywords": [
+    "tripadvisor",
+    "travel",
+    "hotels",
+    "restaurants",
+    "attractions",
+    "reviews",
+    "mcp"
+  ],
+  "skills": "./SKILL.md",
+  "mcp": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "tripadvisor": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/index.js"],
+      "env": {
+        "TRIPADVISOR_API_KEY": "${TRIPADVISOR_API_KEY}",
+        "TRIPADVISOR_REFERER": "${TRIPADVISOR_REFERER}",
+        "TRIPADVISOR_CACHE_TTL": "${TRIPADVISOR_CACHE_TTL}",
+        "TRIPADVISOR_STATIC_CACHE_TTL": "${TRIPADVISOR_STATIC_CACHE_TTL}"
+      }
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# tripadvisor-mcp
+
+[![npm](https://img.shields.io/npm/v/@chrischall/tripadvisor-mcp)](https://www.npmjs.com/package/@chrischall/tripadvisor-mcp)
+
+MCP server for the **TripAdvisor Content API** — travel data for Claude. Search hotels, restaurants, attractions, and destinations by name or coordinates, then pull full details, photos, and recent reviews, all over stdio.
+
+> Developed and maintained by AI (Claude Code). Use at your own discretion.
+
+## Quick start
+
+```json
+{
+  "mcpServers": {
+    "tripadvisor": {
+      "command": "npx",
+      "args": ["-y", "@chrischall/tripadvisor-mcp"],
+      "env": { "TRIPADVISOR_API_KEY": "your-content-api-key-here" }
+    }
+  }
+}
+```
+
+Get a key at [tripadvisor.com/developers](https://www.tripadvisor.com/developers). The free tier is **5,000 calls/month**; responses are cached in-memory to stretch it.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `ta_search_locations` | Search locations by name (optionally scoped by category, lat/long + radius, address, phone) — up to 10 matches |
+| `ta_search_nearby` | Find locations near a latitude/longitude — up to 10 matches |
+| `ta_get_location_details` | Full details: rating, ranking, subratings, awards, review count, amenities, hours, listing URLs |
+| `ta_get_location_photos` | Photos with multi-size image URLs, captions, and source filter |
+| `ta_get_location_reviews` | Most recent reviews (up to 5 per call, pageable with `offset`) |
+
+All tools are read-only — the Content API has no write endpoints.
+
+## Environment
+
+| Var | Required | Purpose |
+| --- | --- | --- |
+| `TRIPADVISOR_API_KEY` | yes | Content API key, sent as the `key` query parameter. |
+| `TRIPADVISOR_REFERER` | no | `Referer` header for domain-restricted keys (the API 403s without a matching referer). |
+| `TRIPADVISOR_CACHE_TTL` | no | Seconds to cache search responses (default: 300; `0` disables). |
+| `TRIPADVISOR_STATIC_CACHE_TTL` | no | Seconds to cache details/photos/reviews (default: 3600; `0` disables). |
+
+## Development
+
+```bash
+npm install
+npm run build   # tsc + esbuild bundle
+npm test        # vitest (no real network)
+```
+
+Endpoint 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.
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: tripadvisor-mcp
+description: TripAdvisor travel data via the official Content API through MCP. Use when the user asks to find hotels, restaurants, attractions, or destinations, look up a place's TripAdvisor rating/reviews/photos, compare places to stay or eat, or find what's near a location. Triggers on phrases like "find a hotel in", "best restaurants near", "TripAdvisor reviews for", "what's the rating of", "things to do in", or "attractions near me". Requires the @chrischall/tripadvisor-mcp package installed and the tripadvisor server registered (see Setup), plus a TripAdvisor Content API key.
+---
+
+# tripadvisor-mcp
+
+MCP server for the **TripAdvisor Content API** — location search, details, photos, and reviews for hotels, restaurants, attractions, and destinations, exposed to Claude over stdio.
+
+- **npm:** [npmjs.com/package/@chrischall/tripadvisor-mcp](https://www.npmjs.com/package/@chrischall/tripadvisor-mcp)
+- **Source:** [github.com/chrischall/tripadvisor-mcp](https://github.com/chrischall/tripadvisor-mcp)
+
+## Setup
+
+### Option A — npx (recommended)
+
+Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "tripadvisor": {
+      "command": "npx",
+      "args": ["-y", "@chrischall/tripadvisor-mcp"],
+      "env": {
+        "TRIPADVISOR_API_KEY": "your-content-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Get a key at [tripadvisor.com/developers](https://www.tripadvisor.com/developers). The free tier is **5,000 calls/month**; the server caches responses in-memory to stretch it.
+
+### Option B — from source
+
+```bash
+git clone https://github.com/chrischall/tripadvisor-mcp
+cd tripadvisor-mcp
+npm install && npm run build
+```
+
+## Environment
+
+| Var | Required | Purpose |
+| --- | --- | --- |
+| `TRIPADVISOR_API_KEY` | yes | Content API key (sent as the `key` query parameter). |
+| `TRIPADVISOR_REFERER` | no | `Referer` header — required if your key was created with a domain restriction. |
+| `TRIPADVISOR_CACHE_TTL` | no | Seconds to cache identical search responses (default: 300; `0` disables). |
+| `TRIPADVISOR_STATIC_CACHE_TTL` | no | Longer TTL for details/photos/reviews (default: 3600; `0` disables). |
+
+## Tools
+
+| Tool | Use for |
+| --- | --- |
+| `ta_search_locations` | Find places by name — `searchQuery` required; filter with `category` (hotels/attractions/restaurants/geos), `latLong` + `radius`/`radiusUnit`, `address`, `phone`, `language`. Returns up to 10 matches with `location_id`. |
+| `ta_search_nearby` | Find places near coordinates — `latLong` ("lat,long") required; same filters. |
+| `ta_get_location_details` | Full listing for a `location_id`: rating, ranking, subratings, awards, review count, amenities, hours, URLs. Optional `language`, `currency`. |
+| `ta_get_location_photos` | Photos (multi-size URLs + captions). Page with `limit`/`offset`; filter `source` to `Expert`, `Management`, `Traveler`. |
+| `ta_get_location_reviews` | Up to 5 most-recent reviews per call; page with `offset`. |
+
+## Workflow
+
+1. `ta_search_locations` (or `ta_search_nearby`) to get `location_id`s.
+2. `ta_get_location_details` for ratings/amenities; `ta_get_location_reviews` and `ta_get_location_photos` for review text and images.
+
+Notes:
+- Everything is **read-only** — the Content API has no write endpoints.
+- A `403` usually means a domain/IP-restricted key: set `TRIPADVISOR_REFERER` to a matching domain.
+- Reviews come back at most 5 per call — page with `offset` for more.