@chrischall/tripadvisor-mcp 0.0.0 → 0.2.0

package/dist/bundle.js

@@ -108,7 +108,7 @@ var require_code = __commonJS({
     }
     exports._ = _;
     var plus = new _Code("+");
-    function str(strs, ...args) {
+    function str2(strs, ...args) {
       const expr = [safeStringify(strs[0])];
       let i = 0;
       while (i < args.length) {
@@ -119,7 +119,7 @@ var require_code = __commonJS({
       optimize(expr);
       return new _Code(expr);
     }
-    exports.str = str;
+    exports.str = str2;
     function addCodeArg(code, arg) {
       if (arg instanceof _Code)
         code.push(...arg._items);
@@ -162,7 +162,7 @@ var require_code = __commonJS({
       return;
     }
     function strConcat(c1, c2) {
-      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str`${c1}${c2}`;
+      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str2`${c1}${c2}`;
     }
     exports.strConcat = strConcat;
     function interpolate(x) {
@@ -1124,22 +1124,22 @@ var require_util = __commonJS({
       return (0, codegen_1._)`${topSchemaRef}${schemaPath}${(0, codegen_1.getProperty)(keyword)}`;
     }
     exports.schemaRefOrVal = schemaRefOrVal;
-    function unescapeFragment(str) {
-      return unescapeJsonPointer(decodeURIComponent(str));
+    function unescapeFragment(str2) {
+      return unescapeJsonPointer(decodeURIComponent(str2));
     }
     exports.unescapeFragment = unescapeFragment;
-    function escapeFragment(str) {
-      return encodeURIComponent(escapeJsonPointer(str));
+    function escapeFragment(str2) {
+      return encodeURIComponent(escapeJsonPointer(str2));
     }
     exports.escapeFragment = escapeFragment;
-    function escapeJsonPointer(str) {
-      if (typeof str == "number")
-        return `${str}`;
-      return str.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPointer(str2) {
+      if (typeof str2 == "number")
+        return `${str2}`;
+      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
     }
     exports.escapeJsonPointer = escapeJsonPointer;
-    function unescapeJsonPointer(str) {
-      return str.replace(/~1/g, "/").replace(/~0/g, "~");
+    function unescapeJsonPointer(str2) {
+      return str2.replace(/~1/g, "/").replace(/~0/g, "~");
     }
     exports.unescapeJsonPointer = unescapeJsonPointer;
     function eachItem(xs, f) {
@@ -2164,8 +2164,8 @@ var require_json_schema_traverse = __commonJS({
         post(schema, jsonPtr, rootSchema, parentJsonPtr, parentKeyword, parentSchema, keyIndex);
       }
     }
-    function escapeJsonPtr(str) {
-      return str.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPtr(str2) {
+      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
     }
   }
 });
@@ -2701,8 +2701,8 @@ var require_validate = __commonJS({
         if (!this.allErrors)
           this.gen.if(cond);
       }
-      setParams(obj, assign) {
-        if (assign)
+      setParams(obj, assign2) {
+        if (assign2)
           Object.assign(this.params, obj);
         else
           this.params = obj;
@@ -3229,10 +3229,10 @@ var require_utils = __commonJS({
         return { host, isIPV6: false };
       }
     }
-    function findToken(str, token) {
+    function findToken(str2, token) {
       let ind = 0;
-      for (let i = 0; i < str.length; i++) {
-        if (str[i] === token) ind++;
+      for (let i = 0; i < str2.length; i++) {
+        if (str2[i] === token) ind++;
       }
       return ind;
     }
@@ -3969,7 +3969,7 @@ var require_core = __commonJS({
     var util_1 = require_util();
     var $dataRefSchema = require_data();
     var uri_1 = require_uri();
-    var defaultRegExp = (str, flags) => new RegExp(str, flags);
+    var defaultRegExp = (str2, flags) => new RegExp(str2, flags);
     defaultRegExp.code = "new RegExp";
     var META_IGNORE_OPTIONS = ["removeAdditional", "useDefaults", "coerceTypes"];
     var EXT_SCOPE_NAMES = /* @__PURE__ */ new Set([
@@ -4764,16 +4764,16 @@ var require_ucs2length = __commonJS({
   "node_modules/ajv/dist/runtime/ucs2length.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    function ucs2length(str) {
-      const len = str.length;
+    function ucs2length(str2) {
+      const len = str2.length;
       let length = 0;
       let pos = 0;
       let value;
       while (pos < len) {
         length++;
-        value = str.charCodeAt(pos++);
+        value = str2.charCodeAt(pos++);
         if (value >= 55296 && value <= 56319 && pos < len) {
-          value = str.charCodeAt(pos);
+          value = str2.charCodeAt(pos);
           if ((value & 64512) === 56320)
             pos++;
         }
@@ -6656,8 +6656,8 @@ var require_formats = __commonJS({
     }
     var DATE = /^(\d\d\d\d)-(\d\d)-(\d\d)$/;
     var DAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-    function date5(str) {
-      const matches = DATE.exec(str);
+    function date5(str2) {
+      const matches = DATE.exec(str2);
       if (!matches)
         return false;
       const year = +matches[1];
@@ -6676,8 +6676,8 @@ var require_formats = __commonJS({
     }
     var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
     function getTime(strictTimeZone) {
-      return function time3(str) {
-        const matches = TIME.exec(str);
+      return function time3(str2) {
+        const matches = TIME.exec(str2);
         if (!matches)
           return false;
         const hr = +matches[1];
@@ -6723,8 +6723,8 @@ var require_formats = __commonJS({
     var DATE_TIME_SEPARATOR = /t|\s/i;
     function getDateTime(strictTimeZone) {
       const time3 = getTime(strictTimeZone);
-      return function date_time(str) {
-        const dateTime = str.split(DATE_TIME_SEPARATOR);
+      return function date_time(str2) {
+        const dateTime = str2.split(DATE_TIME_SEPARATOR);
         return dateTime.length === 2 && date5(dateTime[0]) && time3(dateTime[1]);
       };
     }
@@ -6749,13 +6749,13 @@ var require_formats = __commonJS({
     }
     var NOT_URI_FRAGMENT = /\/|:/;
     var URI = /^(?:[a-z][a-z0-9+\-.]*:)(?:\/?\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\.[a-z0-9\-._~!$&'()*+,;=:]+)\]|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)|(?:[a-z0-9\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\d*)?(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\?(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i;
-    function uri(str) {
-      return NOT_URI_FRAGMENT.test(str) && URI.test(str);
+    function uri(str2) {
+      return NOT_URI_FRAGMENT.test(str2) && URI.test(str2);
     }
     var BYTE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;
-    function byte(str) {
+    function byte(str2) {
       BYTE.lastIndex = 0;
-      return BYTE.test(str);
+      return BYTE.test(str2);
     }
     var MIN_INT32 = -(2 ** 31);
     var MAX_INT32 = 2 ** 31 - 1;
@@ -6769,11 +6769,11 @@ var require_formats = __commonJS({
       return true;
     }
     var Z_ANCHOR = /[^\\]\\Z/;
-    function regex(str) {
-      if (Z_ANCHOR.test(str))
+    function regex(str2) {
+      if (Z_ANCHOR.test(str2))
         return false;
       try {
-        new RegExp(str);
+        new RegExp(str2);
         return true;
       } catch (e) {
         return false;
@@ -7237,26 +7237,26 @@ var require_permessage_deflate = __commonJS({
             value = value[0];
             if (key === "client_max_window_bits") {
               if (value !== true) {
-                const num = +value;
-                if (!Number.isInteger(num) || num < 8 || num > 15) {
+                const num2 = +value;
+                if (!Number.isInteger(num2) || num2 < 8 || num2 > 15) {
                   throw new TypeError(
                     `Invalid value for parameter "${key}": ${value}`
                   );
                 }
-                value = num;
+                value = num2;
               } else if (!this._isServer) {
                 throw new TypeError(
                   `Invalid value for parameter "${key}": ${value}`
                 );
               }
             } else if (key === "server_max_window_bits") {
-              const num = +value;
-              if (!Number.isInteger(num) || num < 8 || num > 15) {
+              const num2 = +value;
+              if (!Number.isInteger(num2) || num2 < 8 || num2 > 15) {
                 throw new TypeError(
                   `Invalid value for parameter "${key}": ${value}`
                 );
               }
-              value = num;
+              value = num2;
             } else if (key === "client_no_context_takeover" || key === "server_no_context_takeover") {
               if (value !== true) {
                 throw new TypeError(
@@ -7969,8 +7969,8 @@ var require_receiver = __commonJS({
           return;
         }
         const buf = this.consume(8);
-        const num = buf.readUInt32BE(0);
-        if (num > Math.pow(2, 53 - 32) - 1) {
+        const num2 = buf.readUInt32BE(0);
+        if (num2 > Math.pow(2, 53 - 32) - 1) {
           const error51 = this.createError(
             RangeError,
             "Unsupported WebSocket frame: payload length > 2^53 - 1",
@@ -7981,7 +7981,7 @@ var require_receiver = __commonJS({
           cb(error51);
           return;
         }
-        this._payloadLength = num * Math.pow(2, 32) + buf.readUInt32BE(4);
+        this._payloadLength = num2 * Math.pow(2, 32) + buf.readUInt32BE(4);
         this.haveLength(cb);
       }
       /**
@@ -14992,14 +14992,14 @@ function promiseAllObject(promisesObj) {
 }
 function randomString(length = 10) {
   const chars = "abcdefghijklmnopqrstuvwxyz";
-  let str = "";
+  let str2 = "";
   for (let i = 0; i < length; i++) {
-    str += chars[Math.floor(Math.random() * chars.length)];
+    str2 += chars[Math.floor(Math.random() * chars.length)];
   }
-  return str;
+  return str2;
 }
-function esc(str) {
-  return JSON.stringify(str);
+function esc(str2) {
+  return JSON.stringify(str2);
 }
 function slugify(input) {
   return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
@@ -15113,8 +15113,8 @@ var primitiveTypes = /* @__PURE__ */ new Set([
   "symbol",
   "undefined"
 ]);
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegex(str2) {
+  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function clone(inst, def, params) {
   const cl = new inst._zod.constr(def ?? inst._zod.def);
@@ -34722,8 +34722,8 @@ function redactSecrets(text) {
   return text.replace(BEARER_RE, "$1[REDACTED]").replace(BASIC_AUTH_RE, "$1[REDACTED]").replace(SET_COOKIE_RE, "$1$2=[REDACTED]").replace(COOKIE_HEADER_RE, (_m, prefix, pairs) => `${prefix}${pairs.replace(/=[^;,\s]*/g, "=[REDACTED]")}`).replace(API_KEY_RE, "[REDACTED]").replace(QUERY_SECRET_RE, "$1[REDACTED]").replace(JWT_RE, "[REDACTED]");
 }
 function truncateErrorMessage(text, max = DEFAULT_ERROR_MESSAGE_MAX) {
-  const str = text === null || text === void 0 ? "" : String(text);
-  const redacted = redactSecrets(str);
+  const str2 = text === null || text === void 0 ? "" : String(text);
+  const redacted = redactSecrets(str2);
   if (redacted.length <= max)
     return redacted;
   return `${redacted.slice(0, max)}\u2026 [truncated]`;
@@ -34841,15 +34841,15 @@ var pageSchema = {
 };
 
 // src/version.ts
-var VERSION = "0.0.0";
+var VERSION = "0.2.0";
 
 // src/client.ts
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 await loadDotenvSafely({ path: join(__dirname, "..", ".env"), override: false });
-var BASE_URL = "https://api.content.tripadvisor.com/api/v1";
-var SERVICE = "TripAdvisor Content API";
+var BASE_URL = "https://terra.tripadvisor.com/api";
+var SERVICE = "TripAdvisor Terra API";
 var REQUEST_TIMEOUT_MS = 3e4;
 var DEFAULT_CACHE_TTL_MS = 3e5;
 var DEFAULT_STATIC_CACHE_TTL_MS = 36e5;
@@ -34864,7 +34864,6 @@ function readCacheTtlMs(envVar, defaultMs) {
 var TripAdvisorClient = class {
   apiKey;
   configError;
-  referer;
   fetchImpl;
   sleep;
   cacheTtlMs;
@@ -34882,12 +34881,11 @@ var TripAdvisorClient = class {
     this.cacheTtlMs = opts.cacheTtlMs ?? readCacheTtlMs("TRIPADVISOR_CACHE_TTL", DEFAULT_CACHE_TTL_MS);
     this.staticCacheTtlMs = opts.staticCacheTtlMs ?? readCacheTtlMs("TRIPADVISOR_STATIC_CACHE_TTL", DEFAULT_STATIC_CACHE_TTL_MS);
     this.fetchImpl = opts.fetchImpl ?? fetch;
-    this.referer = readEnvVar("TRIPADVISOR_REFERER");
     const key = readEnvVar("TRIPADVISOR_API_KEY");
     if (!key) {
       this.apiKey = null;
       this.configError = new McpToolError("TRIPADVISOR_API_KEY environment variable is required", {
-        hint: "Create a Content API key at https://www.tripadvisor.com/developers and set TRIPADVISOR_API_KEY in your MCP host env or .env (free tier: 5,000 calls/month)."
+        hint: "Create a Terra API key at https://www.tripadvisor.com/developers and set TRIPADVISOR_API_KEY in your MCP host env or .env (free Discover tier: 10,000 calls/day)."
       });
     } else {
       this.apiKey = key;
@@ -34929,11 +34927,8 @@ var TripAdvisorClient = class {
   }
   async request(path, isRetry = false) {
     const key = this.requireKey();
-    const sep = path.includes("?") ? "&" : "?";
-    const url2 = `${BASE_URL}${path}${sep}key=${encodeURIComponent(key)}`;
-    const headers = { Accept: "application/json" };
-    if (this.referer) headers.Referer = this.referer;
-    const res = await this.fetchImpl(url2, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
+    const headers = { "X-API-Key": key, Accept: "application/json" };
+    const res = await this.fetchImpl(`${BASE_URL}${path}`, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
     if (res.ok) return await res.json();
     const text = await res.text();
     if (res.status === 429 && !isRetry) {
@@ -34942,22 +34937,20 @@ var TripAdvisorClient = class {
       await this.sleep(delayMs);
       return this.request(path, true);
     }
-    if (res.status === 401) {
-      throw new McpToolError(`${SERVICE} returned 401 Unauthorized \u2014 TRIPADVISOR_API_KEY is missing or invalid.`, {
-        hint: "Check the key in your MCP host env or .env; create one at https://www.tripadvisor.com/developers"
-      });
-    }
-    if (res.status === 403) {
+    if (res.status === 401 || res.status === 403) {
       throw new McpToolError(
-        `${SERVICE} returned 403 Forbidden \u2014 the key is valid but blocked, usually by its domain/IP restriction (set at key creation) or an unapproved application.`,
-        {
-          hint: "If the key is domain-restricted, set TRIPADVISOR_REFERER to a matching https://domain; if IP-restricted, call from a listed address."
-        }
+        `${SERVICE} returned ${res.status} \u2014 TRIPADVISOR_API_KEY is missing, invalid, or not authorized for Terra. A legacy Content API key does NOT work here (and a Terra key does not work on the legacy endpoint).`,
+        { hint: "Confirm the key on the Terra dashboard at https://www.tripadvisor.com/developers and that its plan is active." }
       );
     }
     if (res.status === 429) {
-      throw new McpToolError(`${SERVICE} rate limit or monthly quota exceeded (429).`, {
-        hint: "The free tier is 5,000 calls/month \u2014 check usage at https://www.tripadvisor.com/developers. Cached reads (TRIPADVISOR_CACHE_TTL) stretch the quota."
+      throw new McpToolError(`${SERVICE} rate limit or daily quota exceeded (429).`, {
+        hint: "The Discover tier allows 10 QPS and 10,000 calls/day \u2014 check usage at https://www.tripadvisor.com/developers. Cached reads (TRIPADVISOR_CACHE_TTL) stretch the quota."
+      });
+    }
+    if (res.status === 400) {
+      throw new McpToolError(`${SERVICE} rejected the request (400): ${truncateErrorMessage(text)}`, {
+        hint: "Check the parameters against docs/TRIPADVISOR-API.md (e.g. category must be RESTAURANT/ATTRACTION/HOTEL; nearby needs lat+lon+radius or a bounding box)."
       });
     }
     throw new McpToolError(formatApiError(res.status, "GET", path, text, { service: SERVICE }));
@@ -34967,102 +34960,212 @@ var client = new TripAdvisorClient();
 
 // src/tools/shared.ts
 var LocationId = external_exports.number().int().positive().describe("TripAdvisor location ID (from a search tool)");
-var LatLong = external_exports.string().regex(/^-?\d+(\.\d+)?\s*,\s*-?\d+(\.\d+)?$/, 'must be a "lat,long" pair like "42.3455,-71.10767"');
-var Category = external_exports.enum(["hotels", "attractions", "restaurants", "geos"]);
-var searchFilterParams = {
-  category: Category.optional().describe("Restrict results to one property type"),
-  phone: external_exports.string().optional().describe('Phone number filter (spaces/dashes ok, no leading "+")'),
-  address: external_exports.string().optional().describe("Address filter"),
-  radius: external_exports.number().positive().optional().describe("Search radius around latLong (must be > 0)"),
-  radiusUnit: external_exports.enum(["km", "mi", "m"]).optional().describe("Unit for radius"),
-  language: external_exports.string().optional().describe("Result language code (default: en)")
+var Category = external_exports.enum(["RESTAURANT", "ATTRACTION", "HOTEL"]);
+var LocaleList = external_exports.array(external_exports.string()).optional().describe('Preferred locales for localized fields, in priority order (e.g. ["en","es"])');
+var pageParams = {
+  page: external_exports.number().int().min(1).optional().describe("Page index (1-based)"),
+  size: external_exports.number().int().min(1).max(20).optional().describe("Results per page (max 20)")
 };
 function qs(params) {
   return buildQueryString(params);
 }
 
+// src/projection.ts
+var str = (v) => typeof v === "string" ? v : void 0;
+var numOf = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+function primaryValue(arr) {
+  if (!Array.isArray(arr) || arr.length === 0) return void 0;
+  const primary = arr.find((e) => e && typeof e === "object" && e.primary === true);
+  const pick2 = primary ?? arr[0];
+  return str(pick2?.value);
+}
+function categoryFromUrl(url2) {
+  if (!url2) return void 0;
+  const m = /\/(Attraction|Hotel|Restaurant)_Review/.exec(url2);
+  return m ? m[1].toUpperCase() : void 0;
+}
+function assign(o, k, v) {
+  if (v !== void 0) o[k] = v;
+}
+function compactLocation(loc) {
+  const addr = Array.isArray(loc.addresses) ? loc.addresses[0] : void 0;
+  const url2 = str(loc.urls?.tripadvisor && loc.urls.tripadvisor.main);
+  const overall = loc.traveler_ratings?.overall ?? {};
+  const out = {};
+  assign(out, "id", numOf(loc.id));
+  assign(out, "name", primaryValue(loc.names));
+  assign(out, "category", categoryFromUrl(url2));
+  assign(out, "geo", str(loc.geo));
+  assign(out, "city", str(addr?.city));
+  assign(out, "state", str(addr?.state));
+  assign(out, "rating", numOf(overall.rating));
+  assign(out, "review_count", numOf(overall.count));
+  assign(out, "url", url2);
+  return out;
+}
+function compactList(raw) {
+  const env = raw;
+  const rows = env?.data;
+  if (!Array.isArray(rows) || !rows.every((r) => r && typeof r === "object" && "location" in r)) {
+    console.error("[tripadvisor] compact: unexpected response shape, returning raw payload");
+    return raw;
+  }
+  const data = rows.map((r) => {
+    const row = r;
+    const item = compactLocation(row.location);
+    assign(item, "distance_miles", numOf(row.distance_miles));
+    assign(item, "distance_kilometers", numOf(row.distance_kilometers));
+    return item;
+  });
+  return env.pagination !== void 0 ? { data, pagination: env.pagination } : { data };
+}
+function compactLocationList(raw) {
+  const env = raw;
+  const rows = env?.data;
+  if (!Array.isArray(rows) || !rows.every((r) => r && typeof r === "object" && "id" in r)) {
+    console.error("[tripadvisor] compact: unexpected response shape, returning raw payload");
+    return raw;
+  }
+  return { data: rows.map((r) => compactLocation(r)) };
+}
+
 // src/tools/search.ts
+var compactParam = {
+  compact: external_exports.boolean().optional().describe("Return a slim summary per result (id, name, category, city, rating, review_count, url) instead of full records")
+};
 function registerSearchTools(server) {
   server.registerTool(
     "ta_search_locations",
     {
-      description: "Search TripAdvisor locations (hotels, restaurants, attractions, geos) by name. Returns up to 10 matches with location_id for the detail tools.",
+      description: "Search TripAdvisor locations (restaurants, attractions, hotels) by name. Returns matches with a location id for the detail tools, plus pagination. Pass compact:true for slim summaries.",
       annotations: { readOnlyHint: true, openWorldHint: true },
       inputSchema: {
-        searchQuery: external_exports.string().min(1).describe("Text to search location names for"),
-        latLong: LatLong.optional().describe('Center point to scope the search, e.g. "42.3455,-71.10767"'),
-        ...searchFilterParams
+        query: external_exports.string().min(1).max(500).describe("Text to search location names for"),
+        category: Category.optional().describe("Restrict to one category"),
+        country_code: external_exports.string().length(2).optional().describe('Alpha-2 country code (e.g. "US")'),
+        geo_name: external_exports.string().optional().describe("City, town, or country name to scope the search"),
+        postal_code: external_exports.string().optional().describe("Postal/ZIP code (takes precedence over geo_name)"),
+        locale: LocaleList,
+        ...pageParams,
+        ...compactParam
       }
     },
-    async ({ searchQuery, latLong, category, phone, address, radius, radiusUnit, language }) => {
+    async ({ query, category, country_code, geo_name, postal_code, locale, page, size, compact }) => {
       const data = await client.get(
-        `/location/search${qs({ searchQuery, category, phone, address, latLong, radius, radiusUnit, language })}`,
+        `/locations/search${qs({ query, category, country_code, geo_name, postal_code, locale, page, size })}`,
         { cache: "dynamic" }
       );
-      return textResult(data);
+      return textResult(compact ? compactList(data) : data);
     }
   );
   server.registerTool(
     "ta_search_nearby",
     {
-      description: "Find TripAdvisor locations near a latitude/longitude. Returns up to 10 locations with location_id for the detail tools.",
+      description: "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. Pass compact:true for slim summaries.",
       annotations: { readOnlyHint: true, openWorldHint: true },
       inputSchema: {
-        latLong: LatLong.describe('Center point, e.g. "42.3455,-71.10767"'),
-        ...searchFilterParams
+        // Center — supply exactly one of: lat+lon, location_id, or the sw/ne box.
+        lat: external_exports.number().min(-90).max(90).optional().describe("Center latitude (with lon+radius)"),
+        lon: external_exports.number().min(-180).max(180).optional().describe("Center longitude (with lat+radius)"),
+        location_id: external_exports.number().int().positive().optional().describe("Reference location as center (with radius)"),
+        radius: external_exports.number().positive().optional().describe("Search radius (required with lat/lon or location_id; must be > 0)"),
+        unit: external_exports.enum(["MI", "KM"]).optional().describe("Radius unit (default MI)"),
+        sw_lat: external_exports.number().min(-90).max(90).optional().describe("Bounding box SW latitude"),
+        sw_lon: external_exports.number().min(-180).max(180).optional().describe("Bounding box SW longitude"),
+        ne_lat: external_exports.number().min(-90).max(90).optional().describe("Bounding box NE latitude"),
+        ne_lon: external_exports.number().min(-180).max(180).optional().describe("Bounding box NE longitude"),
+        category: Category.optional().describe("Restrict to one category"),
+        min_rating: external_exports.number().min(1).max(5).optional().describe("Minimum traveler rating (1.0\u20135.0)"),
+        include_photo: external_exports.boolean().optional().describe("Include a photo per result"),
+        sort: external_exports.enum(["distance", "rating"]).optional().describe("Sort order (default distance)"),
+        locale: LocaleList,
+        ...pageParams,
+        ...compactParam
       }
     },
-    async ({ latLong, category, phone, address, radius, radiusUnit, language }) => {
+    async (args) => {
+      const { lat, lon, location_id, radius, sw_lat, sw_lon, ne_lat, ne_lon, compact, ...rest } = args;
+      const boxParts = [sw_lat, sw_lon, ne_lat, ne_lon];
+      const boxGiven = boxParts.filter((v) => v !== void 0).length;
+      if (boxGiven > 0 && boxGiven < 4) {
+        throw new McpToolError("ta_search_nearby bounding box needs all four of sw_lat, sw_lon, ne_lat, ne_lon.", {
+          hint: "Provide all four box corners, or use lat+lon+radius or location_id+radius instead."
+        });
+      }
+      if (lat === void 0 !== (lon === void 0)) {
+        throw new McpToolError("ta_search_nearby needs both lat and lon together (or neither).", {
+          hint: "Provide lat AND lon with a radius, or use location_id+radius or a sw/ne box."
+        });
+      }
+      const hasLatLon = lat !== void 0 && lon !== void 0;
+      const hasBox = boxGiven === 4;
+      const centers = [hasLatLon, location_id !== void 0, hasBox].filter(Boolean).length;
+      if (centers !== 1) {
+        throw new McpToolError(
+          "ta_search_nearby needs exactly one center: lat+lon (+radius), location_id (+radius), or the sw/ne bounding box.",
+          { hint: "Provide lat AND lon, OR location_id, OR all four of sw_lat/sw_lon/ne_lat/ne_lon \u2014 not more than one." }
+        );
+      }
+      if ((hasLatLon || location_id !== void 0) && radius === void 0) {
+        throw new McpToolError("lat/lon and location_id center modes require radius.", {
+          hint: "Add radius (with optional unit MI/KM), or switch to a sw/ne bounding box."
+        });
+      }
       const data = await client.get(
-        `/location/nearby_search${qs({ latLong, category, phone, address, radius, radiusUnit, language })}`,
+        `/locations/nearby${qs({ lat, lon, location_id, radius, sw_lat, sw_lon, ne_lat, ne_lon, ...rest })}`,
         { cache: "dynamic" }
       );
-      return textResult(data);
+      return textResult(compact ? compactList(data) : data);
     }
   );
 }
 
 // src/tools/location.ts
-var PhotoSource = external_exports.string().regex(
-  /^(Expert|Management|Traveler)(,(Expert|Management|Traveler))*$/,
-  "must be a comma-separated list of: Expert, Management, Traveler"
-);
 function registerLocationTools(server) {
+  server.registerTool(
+    "ta_get_locations",
+    {
+      description: "Get details for MULTIPLE locations in one call (batch). Pass an array of location ids \u2014 cheaper than repeated ta_get_location_details. Unknown or unlicensed ids are silently omitted. Pass compact:true for slim summaries.",
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      inputSchema: {
+        ids: external_exports.array(LocationId).min(1).max(50).describe("Location IDs to fetch (1\u201350)"),
+        locale: LocaleList,
+        compact: external_exports.boolean().optional().describe("Return a slim summary per location instead of full records")
+      }
+    },
+    async ({ ids, locale, compact }) => {
+      const data = await client.get(`/locations${qs({ id: ids, locale })}`, { cache: "static" });
+      return textResult(compact ? compactLocationList(data) : data);
+    }
+  );
   server.registerTool(
     "ta_get_location_details",
     {
-      description: "Get full details for a TripAdvisor location: name, address, coordinates, rating, ranking, subratings, awards, review count, amenities, hours, and listing URLs.",
+      description: "Get full details for a TripAdvisor location: names, descriptions, address, coordinates, traveler ratings, phone, category, and listing URLs.",
       annotations: { readOnlyHint: true, openWorldHint: true },
       inputSchema: {
         locationId: LocationId,
-        language: external_exports.string().optional().describe("Result language code (default: en)"),
-        currency: external_exports.string().optional().describe("ISO 4217 currency code for prices (default: USD)")
+        locale: LocaleList
       }
     },
-    async ({ locationId, language, currency }) => {
-      const data = await client.get(`/location/${locationId}/details${qs({ language, currency })}`, {
-        cache: "static"
-      });
+    async ({ locationId, locale }) => {
+      const data = await client.get(`/locations/${locationId}${qs({ locale })}`, { cache: "static" });
       return textResult(data);
     }
   );
   server.registerTool(
     "ta_get_location_photos",
     {
-      description: "Get photos for a TripAdvisor location (multi-size image URLs, captions, sources).",
+      description: "Get photos for a TripAdvisor location (multi-size image URLs, source, dimensions), with pagination.",
       annotations: { readOnlyHint: true, openWorldHint: true },
       inputSchema: {
         locationId: LocationId,
-        language: external_exports.string().optional().describe("Caption language code (default: en)"),
-        limit: external_exports.number().int().positive().optional().describe("Number of photos to return"),
-        offset: external_exports.number().int().min(0).optional().describe("Index of the first photo"),
-        source: PhotoSource.optional().describe(
-          "Comma-separated photo sources to allow: Expert, Management, Traveler (default: all)"
-        )
+        locale: LocaleList,
+        ...pageParams
       }
     },
-    async ({ locationId, language, limit, offset, source }) => {
-      const data = await client.get(`/location/${locationId}/photos${qs({ language, limit, offset, source })}`, {
+    async ({ locationId, locale, page, size }) => {
+      const data = await client.get(`/locations/${locationId}/photos${qs({ locale, page, size })}`, {
         cache: "static"
       });
       return textResult(data);
@@ -35071,17 +35174,16 @@ function registerLocationTools(server) {
   server.registerTool(
     "ta_get_location_reviews",
     {
-      description: "Get the most recent reviews for a TripAdvisor location (up to 5 per call; page with offset).",
+      description: "Get traveler reviews for a TripAdvisor location, with pagination.",
       annotations: { readOnlyHint: true, openWorldHint: true },
       inputSchema: {
         locationId: LocationId,
-        language: external_exports.string().optional().describe("Review language code (default: en)"),
-        limit: external_exports.number().int().positive().optional().describe("Number of reviews to return"),
-        offset: external_exports.number().int().min(0).optional().describe("Index of the first review")
+        locale: LocaleList,
+        ...pageParams
       }
     },
-    async ({ locationId, language, limit, offset }) => {
-      const data = await client.get(`/location/${locationId}/reviews${qs({ language, limit, offset })}`, {
+    async ({ locationId, locale, page, size }) => {
+      const data = await client.get(`/locations/${locationId}/reviews${qs({ locale, page, size })}`, {
         cache: "static"
       });
       return textResult(data);
@@ -38513,6 +38615,56 @@ function createTripAdvisorTransport(createServer2) {
   });
 }
 
+// src/web/parse.ts
+function locationDetailPath(locationId) {
+  return `/Attraction_Review-g1-d${locationId}-Reviews-a-a.html`;
+}
+function ldJsonBlocks(html) {
+  const out = [];
+  for (const m of html.matchAll(/<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi)) {
+    try {
+      out.push(JSON.parse(m[1].trim()));
+    } catch {
+    }
+  }
+  return out;
+}
+function num(v) {
+  if (v === void 0 || v === null) return void 0;
+  const n = typeof v === "number" ? v : Number(v);
+  return Number.isFinite(n) ? n : void 0;
+}
+function parseLocationDetail(html) {
+  const node = ldJsonBlocks(html).find(
+    (b) => typeof b === "object" && b !== null && typeof b.name === "string" && "aggregateRating" in b
+  );
+  if (!node) return null;
+  const rating = node.aggregateRating ?? {};
+  const geo = node.geo ?? {};
+  const detail = { name: node.name };
+  const assign2 = (key, value) => {
+    if (value !== void 0) detail[key] = value;
+  };
+  assign2("type", typeof node["@type"] === "string" ? node["@type"] : void 0);
+  assign2("url", typeof node.url === "string" ? node.url : void 0);
+  assign2("rating", num(rating.ratingValue));
+  assign2("review_count", num(rating.reviewCount));
+  assign2("best_rating", num(rating.bestRating));
+  assign2("telephone", typeof node.telephone === "string" ? node.telephone : void 0);
+  assign2("image", typeof node.image === "string" ? node.image : void 0);
+  assign2("latitude", num(geo.latitude));
+  assign2("longitude", num(geo.longitude));
+  assign2("same_as", typeof node.sameAs === "string" ? node.sameAs : void 0);
+  if (node.address && typeof node.address === "object") {
+    const addr = {};
+    for (const [k, v] of Object.entries(node.address)) {
+      if (k !== "@type" && typeof v === "string") addr[k] = v;
+    }
+    if (Object.keys(addr).length) detail.address = addr;
+  }
+  return detail;
+}
+
 // src/web/client.ts
 var TripAdvisorWebClient = class {
   constructor(injected = {}) {
@@ -38599,6 +38751,10 @@ var TripAdvisorWebClient = class {
       });
     }
   }
+  /** Fetch a location detail page's HTML by numeric d-id (canonicalized by TripAdvisor). */
+  async getLocationHtml(locationId) {
+    return this.getHtml(locationDetailPath(locationId));
+  }
   assertNotWalled(status, body, path) {
     const wall = classifyBotWall(body, status);
     if (wall.blocked) {
@@ -38626,6 +38782,26 @@ function registerWebTools(server) {
     },
     probeFn: (path) => webClient.getHtml(path)
   });
+  server.registerTool(
+    "ta_web_get_location",
+    {
+      description: "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 \u2014 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.",
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      inputSchema: {
+        locationId: LocationId
+      }
+    },
+    async ({ locationId }) => {
+      const html = await webClient.getLocationHtml(locationId);
+      const detail = parseLocationDetail(html);
+      if (!detail) {
+        throw new McpToolError(`Could not parse location ${locationId} from its TripAdvisor page.`, {
+          hint: "The page may be a bot-challenge shell or the id may be wrong \u2014 run ta_web_healthcheck and confirm a signed-in www.tripadvisor.com tab is open, then retry."
+        });
+      }
+      return textResult({ location_id: locationId, ...detail });
+    }
+  );
 }
 
 // src/index.ts