untappd-mcp 1.0.0 → 1.2.0

package/dist/bundle.js

@@ -2220,20 +2220,20 @@ var require_resolve = __commonJS({
       return false;
     }
     function countKeys(schema) {
-      let count = 0;
+      let count2 = 0;
       for (const key in schema) {
         if (key === "$ref")
           return Infinity;
-        count++;
+        count2++;
         if (SIMPLE_INLINED.has(key))
           continue;
         if (typeof schema[key] == "object") {
-          (0, util_1.eachItem)(schema[key], (sch) => count += countKeys(sch));
+          (0, util_1.eachItem)(schema[key], (sch) => count2 += countKeys(sch));
         }
-        if (count === Infinity)
+        if (count2 === Infinity)
           return Infinity;
       }
-      return count;
+      return count2;
     }
     function getFullPath(resolver, id = "", normalize) {
       if (normalize !== false)
@@ -5405,8 +5405,8 @@ var require_contains = __commonJS({
         cxt.result(valid, () => cxt.reset());
         function validateItemsWithCount() {
           const schValid = gen.name("_valid");
-          const count = gen.let("count", 0);
-          validateItems(schValid, () => gen.if(schValid, () => checkLimits(count)));
+          const count2 = gen.let("count", 0);
+          validateItems(schValid, () => gen.if(schValid, () => checkLimits(count2)));
         }
         function validateItems(_valid, block) {
           gen.forRange("i", 0, len, (i) => {
@@ -5419,16 +5419,16 @@ var require_contains = __commonJS({
             block();
           });
         }
-        function checkLimits(count) {
-          gen.code((0, codegen_1._)`${count}++`);
+        function checkLimits(count2) {
+          gen.code((0, codegen_1._)`${count2}++`);
           if (max === void 0) {
-            gen.if((0, codegen_1._)`${count} >= ${min}`, () => gen.assign(valid, true).break());
+            gen.if((0, codegen_1._)`${count2} >= ${min}`, () => gen.assign(valid, true).break());
           } else {
-            gen.if((0, codegen_1._)`${count} > ${max}`, () => gen.assign(valid, false).break());
+            gen.if((0, codegen_1._)`${count2} > ${max}`, () => gen.assign(valid, false).break());
             if (min === 1)
               gen.assign(valid, true);
             else
-              gen.if((0, codegen_1._)`${count} >= ${min}`, () => gen.assign(valid, true));
+              gen.if((0, codegen_1._)`${count2} >= ${min}`, () => gen.assign(valid, true));
           }
         }
       }
@@ -15158,8 +15158,8 @@ function az_default() {
 }
 
 // node_modules/zod/v4/locales/be.js
-function getBelarusianPlural(count, one, few, many) {
-  const absCount = Math.abs(count);
+function getBelarusianPlural(count2, one, few, many) {
+  const absCount = Math.abs(count2);
   const lastDigit = absCount % 10;
   const lastTwoDigits = absCount % 100;
   if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
@@ -17237,8 +17237,8 @@ function hu_default() {
 }
 
 // node_modules/zod/v4/locales/hy.js
-function getArmenianPlural(count, one, many) {
-  return Math.abs(count) === 1 ? one : many;
+function getArmenianPlural(count2, one, many) {
+  return Math.abs(count2) === 1 ? one : many;
 }
 function withDefiniteArticle(word) {
   if (!word)
@@ -19366,8 +19366,8 @@ function ro_default() {
 }
 
 // node_modules/zod/v4/locales/ru.js
-function getRussianPlural(count, one, few, many) {
-  const absCount = Math.abs(count);
+function getRussianPlural(count2, one, few, many) {
+  const absCount = Math.abs(count2);
   const lastDigit = absCount % 10;
   const lastTwoDigits = absCount % 100;
   if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
@@ -31184,13 +31184,15 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.0.0";
+var VERSION = "1.2.0";
 
 // src/client.ts
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-await loadDotenvSafely({ path: join(__dirname, "..", ".env"), override: false });
+if (import.meta.url) {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  await loadDotenvSafely({ path: join(__dirname, "..", ".env"), override: false });
+}
 var BASE_URL = "https://api.untappd.com/v4";
 var SERVICE = "Untappd";
 var REQUEST_TIMEOUT_MS = 3e4;
@@ -31205,15 +31207,72 @@ var DEFAULTS = {
   // works. Override with UNTAPPD_DEVICE_ID to pin your own.
   deviceUdid: "A1B2C3D4-0000-4000-8000-0000000000AA"
 };
-function readCredentials() {
-  const username = readEnvVar("UNTAPPD_USERNAME");
-  const password = readEnvVar("UNTAPPD_PASSWORD");
-  const clientId = readEnvVar("UNTAPPD_CLIENT_ID");
-  const clientSecret = readEnvVar("UNTAPPD_CLIENT_SECRET");
-  if (username && password && clientId && clientSecret) {
-    return { username, password, clientId, clientSecret };
+async function sendRequest(fetchImpl, method, url2, init) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    return await fetchImpl(url2, {
+      method,
+      headers: init.headers,
+      ...init.body !== void 0 ? { body: init.body } : {},
+      signal: controller.signal
+    });
+  } catch {
+    throw new UnreachableError(SERVICE);
+  } finally {
+    clearTimeout(timer);
   }
-  return null;
+}
+function xauthHeaders(userAgent) {
+  return {
+    "User-Agent": userAgent,
+    Accept: "application/json",
+    "x-untappd-app": "ios",
+    "x-untappd-app-version": DEFAULTS.appVersion
+  };
+}
+async function xauthLogin(creds, opts = {}) {
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const utv = opts.utv ?? readEnvVar("UNTAPPD_UTV") ?? DEFAULTS.utv;
+  const deviceUdid = opts.deviceUdid ?? readEnvVar("UNTAPPD_DEVICE_ID") ?? DEFAULTS.deviceUdid;
+  const userAgent = opts.userAgent ?? readEnvVar("UNTAPPD_USER_AGENT") ?? DEFAULTS.userAgent;
+  const qs = buildQueryString({ client_id: creds.clientId, client_secret: creds.clientSecret, utv });
+  const form = new URLSearchParams({
+    user_name: creds.username,
+    user_password: creds.password,
+    device_udid: deviceUdid,
+    device_name: DEFAULTS.deviceName,
+    device_version: DEFAULTS.deviceVersion,
+    device_platform: DEFAULTS.devicePlatform,
+    app_version: DEFAULTS.appVersion,
+    multi_account: "true"
+  });
+  const res = await sendRequest(fetchImpl, "POST", `${BASE_URL}/xauth${qs}`, {
+    headers: { ...xauthHeaders(userAgent), "Content-Type": "application/x-www-form-urlencoded" },
+    body: form.toString()
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    if (res.status === 401 || res.status === 400) {
+      throw createHelpfulError(`Untappd login failed (${res.status}).`, {
+        hint: "Check UNTAPPD_USERNAME / UNTAPPD_PASSWORD, and that UNTAPPD_CLIENT_ID / UNTAPPD_CLIENT_SECRET are the mobile app credentials."
+      });
+    }
+    throw new McpToolError(formatApiError(res.status, "POST", "/xauth", text, { service: SERVICE }));
+  }
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    throw new McpToolError("Untappd login returned a non-JSON response.");
+  }
+  const token = data?.response?.access_token;
+  if (!token) {
+    throw createHelpfulError("Untappd login did not return an access token.", {
+      hint: data?.response?.two_factor_enabled ? "This account has two-factor authentication enabled, which xauth login cannot satisfy." : "The credentials may be incorrect."
+    });
+  }
+  return token;
 }
 function missingCredsError() {
   const missing = ["UNTAPPD_USERNAME", "UNTAPPD_PASSWORD", "UNTAPPD_CLIENT_ID", "UNTAPPD_CLIENT_SECRET"].filter((k) => !readEnvVar(k));
@@ -31226,8 +31285,11 @@ function missingCredsError() {
 }
 var UntappdClient = class {
   fetchImpl;
-  creds;
-  configError;
+  clientId;
+  clientSecret;
+  username;
+  password;
+  _loginName;
   utv = readEnvVar("UNTAPPD_UTV") ?? DEFAULTS.utv;
   deviceUdid = readEnvVar("UNTAPPD_DEVICE_ID") ?? DEFAULTS.deviceUdid;
   userAgent = readEnvVar("UNTAPPD_USER_AGENT") ?? DEFAULTS.userAgent;
@@ -31241,26 +31303,31 @@ var UntappdClient = class {
   constructor(opts = {}) {
     this.fetchImpl = opts.fetchImpl ?? fetch;
     this.token = opts.token ?? null;
-    const creds = opts.credentials !== void 0 ? opts.credentials : readCredentials();
-    if (creds) {
-      this.creds = creds;
-      this.configError = null;
-    } else {
-      this.creds = null;
-      this.configError = missingCredsError();
-    }
+    this.clientId = opts.clientId ?? readEnvVar("UNTAPPD_CLIENT_ID") ?? null;
+    this.clientSecret = opts.clientSecret ?? readEnvVar("UNTAPPD_CLIENT_SECRET") ?? null;
+    this.username = opts.username ?? readEnvVar("UNTAPPD_USERNAME") ?? null;
+    this.password = opts.password ?? readEnvVar("UNTAPPD_PASSWORD") ?? null;
+    this._loginName = opts.loginName ?? this.username;
   }
-  /** Whether credentials are configured (used by the healthcheck tool). */
+  /** True when enough is configured to make authenticated calls. */
   get configured() {
-    return this.configError === null;
+    if (this.token) return Boolean(this.clientId && this.clientSecret);
+    return Boolean(this.clientId && this.clientSecret && this.username && this.password);
   }
   /** The configured login name — the default `username` for user-scoped tools. */
   get loginName() {
-    return this.creds?.username ?? null;
+    return this._loginName;
+  }
+  requireAppCreds() {
+    if (!this.clientId || !this.clientSecret) {
+      throw missingCredsError();
+    }
+    return { clientId: this.clientId, clientSecret: this.clientSecret };
   }
-  requireCreds() {
-    if (this.configError) throw this.configError;
-    return this.creds;
+  requireLogin() {
+    const app = this.requireAppCreds();
+    if (!this.username || !this.password) throw missingCredsError();
+    return { ...app, username: this.username, password: this.password };
   }
   baseHeaders() {
     return {
@@ -31270,23 +31337,10 @@ var UntappdClient = class {
       "x-untappd-app-version": DEFAULTS.appVersion
     };
   }
-  // One HTTP attempt with a hard timeout. Network/timeout failures become an
-  // UnreachableError; HTTP status handling is left to the caller.
+  // One HTTP attempt with a hard timeout, delegating to the module-level
+  // helper shared with `xauthLogin()`.
   async send(method, url2, init) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-    try {
-      return await this.fetchImpl(url2, {
-        method,
-        headers: init.headers,
-        ...init.body !== void 0 ? { body: init.body } : {},
-        signal: controller.signal
-      });
-    } catch {
-      throw new UnreachableError(SERVICE);
-    } finally {
-      clearTimeout(timer);
-    }
+    return sendRequest(this.fetchImpl, method, url2, init);
   }
   /**
    * Obtain an access token, logging in via xauth (username/password) on demand.
@@ -31303,43 +31357,13 @@ var UntappdClient = class {
     return this.loginInFlight;
   }
   async login() {
-    const c = this.requireCreds();
-    const qs = buildQueryString({ client_id: c.clientId, client_secret: c.clientSecret, utv: this.utv });
-    const form = new URLSearchParams({
-      user_name: c.username,
-      user_password: c.password,
-      device_udid: this.deviceUdid,
-      device_name: DEFAULTS.deviceName,
-      device_version: DEFAULTS.deviceVersion,
-      device_platform: DEFAULTS.devicePlatform,
-      app_version: DEFAULTS.appVersion,
-      multi_account: "true"
+    const c = this.requireLogin();
+    const token = await xauthLogin(c, {
+      fetchImpl: this.fetchImpl,
+      utv: this.utv,
+      deviceUdid: this.deviceUdid,
+      userAgent: this.userAgent
     });
-    const res = await this.send("POST", `${BASE_URL}/xauth${qs}`, {
-      headers: { ...this.baseHeaders(), "Content-Type": "application/x-www-form-urlencoded" },
-      body: form.toString()
-    });
-    const text = await res.text();
-    if (!res.ok) {
-      if (res.status === 401 || res.status === 400) {
-        throw createHelpfulError(`Untappd login failed (${res.status}).`, {
-          hint: "Check UNTAPPD_USERNAME / UNTAPPD_PASSWORD, and that UNTAPPD_CLIENT_ID / UNTAPPD_CLIENT_SECRET are the mobile app credentials."
-        });
-      }
-      throw new McpToolError(formatApiError(res.status, "POST", "/xauth", text, { service: SERVICE }));
-    }
-    let data;
-    try {
-      data = JSON.parse(text);
-    } catch {
-      throw new McpToolError("Untappd login returned a non-JSON response.");
-    }
-    const token = data?.response?.access_token;
-    if (!token) {
-      throw createHelpfulError("Untappd login did not return an access token.", {
-        hint: data?.response?.two_factor_enabled ? "This account has two-factor authentication enabled, which xauth login cannot satisfy." : "The credentials may be incorrect."
-      });
-    }
     this.token = token;
     return token;
   }
@@ -31372,7 +31396,7 @@ var UntappdClient = class {
     const headers = this.baseHeaders();
     let query;
     if (opts.auth === "bearer") {
-      const c = this.requireCreds();
+      const c = this.requireAppCreds();
       headers["Authorization"] = `Bearer ${token}`;
       query = { ...opts.query, client_id: c.clientId, client_secret: c.clientSecret, utv: this.utv };
     } else {
@@ -31420,11 +31444,86 @@ var UntappdClient = class {
     }
   }
 };
-var client = new UntappdClient();
+
+// src/compact.ts
+function asDict(v) {
+  return v && typeof v === "object" ? v : void 0;
+}
+function count(v) {
+  const d = asDict(v);
+  if (!d) return void 0;
+  return d.count ?? d.total_count;
+}
+function compactCheckin(item) {
+  const c = asDict(item) ?? {};
+  const beer = asDict(c.beer);
+  const brewery = asDict(c.brewery);
+  const venue = asDict(c.venue);
+  const user = asDict(c.user);
+  return {
+    checkin_id: c.checkin_id,
+    created_at: c.created_at,
+    user: user?.user_name,
+    rating: c.rating_score,
+    comment: c.checkin_comment || void 0,
+    beer: beer && { bid: beer.bid, name: beer.beer_name, style: beer.beer_style, abv: beer.beer_abv },
+    brewery: brewery?.brewery_name,
+    venue: venue?.venue_name || void 0,
+    toasts: count(c.toasts),
+    comments: count(c.comments),
+    has_photo: (count(c.media) ?? 0) > 0
+  };
+}
+function beerCore(item) {
+  const beer = asDict(item.beer) ?? {};
+  const brewery = asDict(item.brewery);
+  return {
+    bid: beer.bid,
+    name: beer.beer_name,
+    style: beer.beer_style,
+    abv: beer.beer_abv,
+    ibu: beer.beer_ibu,
+    brewery: brewery?.brewery_name
+  };
+}
+function compactBeerResult(item) {
+  const i = asDict(item) ?? {};
+  return { ...beerCore(i), checkin_count: i.checkin_count, have_had: i.have_had };
+}
+function compactWishlistBeer(item) {
+  const i = asDict(item) ?? {};
+  return { ...beerCore(i), added_at: i.created_at };
+}
+function compactUserBeer(item) {
+  const i = asDict(item) ?? {};
+  return {
+    ...beerCore(i),
+    your_count: i.count,
+    your_rating: i.user_auth_rating_score || void 0,
+    global_rating: i.rating_score || void 0,
+    last_had: i.recent_created_at
+  };
+}
+function projectItems(resp, container, mapFn) {
+  const r = asDict(resp);
+  const box = asDict(r?.[container]);
+  const items = box?.items;
+  if (!r || !box || !Array.isArray(items)) {
+    process.stderr.write(`[untappd-mcp] compact: expected ${container}.items array; returning raw response
+`);
+    return resp;
+  }
+  return { ...r, [container]: { ...box, items: items.map(mapFn) } };
+}
+var compactCheckins = (resp) => projectItems(resp, "checkins", compactCheckin);
+var compactBeerSearch = (resp) => projectItems(resp, "beers", compactBeerResult);
+var compactWishlist = (resp) => projectItems(resp, "beers", compactWishlistBeer);
+var compactUserBeers = (resp) => projectItems(resp, "beers", compactUserBeer);
 
 // src/tools/beer.ts
 var BidSchema = external_exports.number().int().positive().describe("Untappd beer id (bid)");
-function registerBeerTools(server) {
+var CompactCheckins = external_exports.boolean().optional().describe("Project each check-in to a slim summary (id, user, beer, rating, comment, venue, toast/comment counts) to save context (default false)");
+function registerBeerTools(server, client2) {
   server.registerTool(
     "untappd_search_beer",
     {
@@ -31435,12 +31534,13 @@ function registerBeerTools(server) {
         query: external_exports.string().min(1).describe("Beer name to search for"),
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max results (1\u201350, default 25)"),
         offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)"),
-        sort: external_exports.enum(["checkin", "name", "count"]).optional().describe("Sort order: checkin (relevance, default), name, or count")
+        sort: external_exports.enum(["checkin", "name", "count"]).optional().describe("Sort order: checkin (relevance, default), name, or count"),
+        compact: external_exports.boolean().optional().describe("Project each result to a slim summary (bid, name, brewery, style, abv, ibu, counts) to save context (default false)")
       }
     },
-    async ({ query, limit, offset, sort }) => {
-      const data = await client.get("/search/beer", { q: query, limit, offset, sort });
-      return textResult(data);
+    async ({ query, limit, offset, sort, compact }) => {
+      const data = await client2.get("/search/beer", { q: query, limit, offset, sort });
+      return textResult(compact ? compactBeerSearch(data) : data);
     }
   );
   server.registerTool(
@@ -31455,7 +31555,7 @@ function registerBeerTools(server) {
       }
     },
     async ({ bid, compact }) => {
-      const data = await client.get(`/beer/info/${bid}`, { compact: compact ? "true" : void 0 });
+      const data = await client2.get(`/beer/info/${bid}`, { compact: compact ? "true" : void 0 });
       return textResult(data);
     }
   );
@@ -31468,18 +31568,19 @@ function registerBeerTools(server) {
       inputSchema: {
         bid: BidSchema,
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
-        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)"),
+        compact: CompactCheckins
       }
     },
-    async ({ bid, limit, max_id }) => {
-      const data = await client.get(`/beer/checkins/${bid}`, { limit, max_id });
-      return textResult(data);
+    async ({ bid, limit, max_id, compact }) => {
+      const data = await client2.get(`/beer/checkins/${bid}`, { limit, max_id });
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
 
 // src/tools/brewery.ts
-function registerBreweryTools(server) {
+function registerBreweryTools(server, client2) {
   server.registerTool(
     "untappd_search_brewery",
     {
@@ -31493,7 +31594,7 @@ function registerBreweryTools(server) {
       }
     },
     async ({ query, limit, offset }) => {
-      const data = await client.get("/search/brewery", { q: query, limit, offset });
+      const data = await client2.get("/search/brewery", { q: query, limit, offset });
       return textResult(data);
     }
   );
@@ -31509,7 +31610,7 @@ function registerBreweryTools(server) {
       }
     },
     async ({ brewery_id, compact }) => {
-      const data = await client.get(`/brewery/info/${brewery_id}`, { compact: compact ? "true" : void 0 });
+      const data = await client2.get(`/brewery/info/${brewery_id}`, { compact: compact ? "true" : void 0 });
       return textResult(data);
     }
   );
@@ -31527,14 +31628,14 @@ function registerBreweryTools(server) {
       }
     },
     async ({ brewery_id, limit, offset, sort }) => {
-      const data = await client.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
+      const data = await client2.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
       return textResult(data);
     }
   );
 }
 
 // src/tools/venue.ts
-function registerVenueTools(server) {
+function registerVenueTools(server, client2) {
   server.registerTool(
     "untappd_search_venue",
     {
@@ -31547,7 +31648,7 @@ function registerVenueTools(server) {
       }
     },
     async ({ query, limit }) => {
-      const data = await client.get("/search/venue", { q: query, limit });
+      const data = await client2.get("/search/venue", { q: query, limit });
       return textResult(data);
     }
   );
@@ -31563,7 +31664,22 @@ function registerVenueTools(server) {
       }
     },
     async ({ venue_id, compact }) => {
-      const data = await client.get(`/venue/info/${venue_id}`, { compact: compact ? "true" : void 0 });
+      const data = await client2.get(`/venue/info/${venue_id}`, { compact: compact ? "true" : void 0 });
+      return textResult(data);
+    }
+  );
+  server.registerTool(
+    "untappd_venue_by_foursquare",
+    {
+      title: "Look up an Untappd venue by Foursquare id",
+      description: "Resolve a Foursquare venue id to its Untappd venue. Useful to turn a foursquare_id (e.g. from a check-in) into an Untappd venue you can pass to untappd_venue_info / untappd_venue_activity. Read-only.",
+      annotations: toolAnnotations({ title: "Look up an Untappd venue by Foursquare id", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        foursquare_id: external_exports.string().min(1).describe("Foursquare venue id")
+      }
+    },
+    async ({ foursquare_id }) => {
+      const data = await client2.get(`/venue/foursquare_lookup/${encodeURIComponent(foursquare_id)}`);
       return textResult(data);
     }
   );
@@ -31576,20 +31692,21 @@ function registerVenueTools(server) {
       inputSchema: {
         venue_id: external_exports.number().int().positive().describe("Untappd venue id"),
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
-        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)"),
+        compact: external_exports.boolean().optional().describe("Project each check-in to a slim summary to save context (default false)")
       }
     },
-    async ({ venue_id, limit, max_id }) => {
-      const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
-      return textResult(data);
+    async ({ venue_id, limit, max_id, compact }) => {
+      const data = await client2.get(`/venue/checkins/${venue_id}`, { limit, max_id });
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
 
 // src/tools/user.ts
 var UsernameArg = external_exports.string().min(1).optional().describe("Untappd username. Omit to use your own configured account (UNTAPPD_USERNAME).");
-function resolveUser(username) {
-  const u = username ?? client.loginName;
+function resolveUser(username, loginName) {
+  const u = username ?? loginName;
   if (!u) {
     throw createHelpfulError("No username given and no configured account to fall back to.", {
       hint: "Pass `username`, or set UNTAPPD_USERNAME so user tools default to your own account."
@@ -31597,7 +31714,7 @@ function resolveUser(username) {
   }
   return encodeURIComponent(u);
 }
-function registerUserTools(server) {
+function registerUserTools(server, client2) {
   server.registerTool(
     "untappd_user_info",
     {
@@ -31610,7 +31727,7 @@ function registerUserTools(server) {
       }
     },
     async ({ username, compact }) => {
-      const data = await client.get(`/user/info/${resolveUser(username)}`, { compact: compact ? "true" : void 0 });
+      const data = await client2.get(`/user/info/${resolveUser(username, client2.loginName)}`, { compact: compact ? "true" : void 0 });
       return textResult(data);
     }
   );
@@ -31623,12 +31740,13 @@ function registerUserTools(server) {
       inputSchema: {
         username: UsernameArg,
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
-        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)"),
+        compact: external_exports.boolean().optional().describe("Project each check-in to a slim summary to save context (default false)")
       }
     },
-    async ({ username, limit, max_id }) => {
-      const data = await client.get(`/user/checkins/${resolveUser(username)}`, { limit, max_id });
-      return textResult(data);
+    async ({ username, limit, max_id, compact }) => {
+      const data = await client2.get(`/user/checkins/${resolveUser(username, client2.loginName)}`, { limit, max_id });
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
   server.registerTool(
@@ -31641,12 +31759,13 @@ function registerUserTools(server) {
         username: UsernameArg,
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max beers (1\u201350, default 25)"),
         offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)"),
-        sort: external_exports.enum(["date", "name", "brewery", "style", "rating", "abv"]).optional().describe("Sort order (default date added, newest first)")
+        sort: external_exports.enum(["date", "name", "brewery", "style", "rating", "abv"]).optional().describe("Sort order (default date added, newest first)"),
+        compact: external_exports.boolean().optional().describe("Project each beer to a slim summary (bid, name, brewery, style, abv, added_at) to save context (default false)")
       }
     },
-    async ({ username, limit, offset, sort }) => {
-      const data = await client.get(`/user/wishlist/${resolveUser(username)}`, { limit, offset, sort });
-      return textResult(data);
+    async ({ username, limit, offset, sort, compact }) => {
+      const data = await client2.get(`/user/wishlist/${resolveUser(username, client2.loginName)}`, { limit, offset, sort });
+      return textResult(compact ? compactWishlist(data) : data);
     }
   );
   server.registerTool(
@@ -31659,12 +31778,13 @@ function registerUserTools(server) {
         username: UsernameArg,
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max beers (1\u201350, default 25)"),
         offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)"),
-        sort: external_exports.enum(["date", "checkin", "highest_rated", "lowest_rated", "name", "this_month", "highest_abv"]).optional().describe("Sort order (default date, most recent first)")
+        sort: external_exports.enum(["date", "checkin", "highest_rated", "lowest_rated", "name", "this_month", "highest_abv"]).optional().describe("Sort order (default date, most recent first)"),
+        compact: external_exports.boolean().optional().describe("Project each beer to a slim summary (bid, name, brewery, style, abv, ibu, your_count, your_rating, global_rating, last_had) to save context (default false)")
       }
     },
-    async ({ username, limit, offset, sort }) => {
-      const data = await client.get(`/user/beers/${resolveUser(username)}`, { limit, offset, sort });
-      return textResult(data);
+    async ({ username, limit, offset, sort, compact }) => {
+      const data = await client2.get(`/user/beers/${resolveUser(username, client2.loginName)}`, { limit, offset, sort });
+      return textResult(compact ? compactUserBeers(data) : data);
     }
   );
   server.registerTool(
@@ -31680,7 +31800,7 @@ function registerUserTools(server) {
       }
     },
     async ({ username, limit, offset }) => {
-      const data = await client.get(`/user/badges/${resolveUser(username)}`, { limit, offset });
+      const data = await client2.get(`/user/badges/${resolveUser(username, client2.loginName)}`, { limit, offset });
       return textResult(data);
     }
   );
@@ -31697,14 +31817,48 @@ function registerUserTools(server) {
       }
     },
     async ({ username, limit, offset }) => {
-      const data = await client.get(`/user/friends/${resolveUser(username)}`, { limit, offset });
+      const data = await client2.get(`/user/friends/${resolveUser(username, client2.loginName)}`, { limit, offset });
+      return textResult(data);
+    }
+  );
+  server.registerTool(
+    "untappd_user_venues",
+    {
+      title: "Get venues a user has checked in at",
+      description: "Get the venues a user has checked in at, most recent first, with per-venue check-in counts. Supports sorting and paging. Omit username for your own account. Read-only.",
+      annotations: toolAnnotations({ title: "Get venues a user has checked in at", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        username: UsernameArg,
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max venues (1\u201350, default 25)"),
+        offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)"),
+        sort: external_exports.enum(["date", "name", "checkin", "highest_rated"]).optional().describe("Sort order (default most recent)")
+      }
+    },
+    async ({ username, limit, offset, sort }) => {
+      const data = await client2.get(`/user/venues/${resolveUser(username, client2.loginName)}`, { limit, offset, sort });
+      return textResult(data);
+    }
+  );
+  server.registerTool(
+    "untappd_pending_friends",
+    {
+      title: "Get your pending friend requests",
+      description: "Get the incoming friend requests waiting on YOUR account \u2014 the users who have requested to be your friend. Read-only.",
+      annotations: toolAnnotations({ title: "Get your pending friend requests", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max requests (1\u201350, default 25)"),
+        offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      const data = await client2.get("/user/pending", { limit, offset });
       return textResult(data);
     }
   );
 }
 
 // src/tools/feed.ts
-function registerFeedTools(server) {
+function registerFeedTools(server, client2) {
   server.registerTool(
     "untappd_activity_feed",
     {
@@ -31713,12 +31867,13 @@ function registerFeedTools(server) {
       annotations: toolAnnotations({ title: "Get Untappd friend activity feed", readOnly: true, idempotent: false, openWorld: true }),
       inputSchema: {
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
-        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)"),
+        compact: external_exports.boolean().optional().describe("Project each check-in to a slim summary to save context (default false)")
       }
     },
-    async ({ limit, max_id }) => {
-      const data = await client.get("/checkin/recent", { limit, max_id });
-      return textResult(data);
+    async ({ limit, max_id, compact }) => {
+      const data = await client2.get("/checkin/recent", { limit, max_id });
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
   server.registerTool(
@@ -31732,14 +31887,88 @@ function registerFeedTools(server) {
       }
     },
     async ({ checkin_id }) => {
-      const data = await client.get(`/checkin/view/${checkin_id}`);
+      const data = await client2.get(`/checkin/view/${checkin_id}`);
       return textResult(data);
     }
   );
 }
 
+// src/tools/resolve.ts
+function parseUntappdUrl(input) {
+  let url2;
+  try {
+    url2 = new URL(input.trim());
+  } catch {
+    return null;
+  }
+  if (!/(^|\.)untappd\.com$/i.test(url2.hostname)) return null;
+  const segs = url2.pathname.split("/").filter(Boolean);
+  if (segs[0] === "user" && segs[2] === "checkin" && /^\d+$/.test(segs[3] ?? "")) {
+    return { type: "checkin", id: Number(segs[3]), username: segs[1], tool: "untappd_checkin_info" };
+  }
+  if (segs[0] === "user" && segs[1]) {
+    return { type: "user", username: segs[1], tool: "untappd_user_info" };
+  }
+  const short = {
+    b: { type: "beer", tool: "untappd_beer_info" },
+    w: { type: "brewery", tool: "untappd_brewery_info" },
+    v: { type: "venue", tool: "untappd_venue_info" }
+  };
+  if (segs[0] && short[segs[0]]) {
+    const last = segs[segs.length - 1];
+    if (/^\d+$/.test(last)) {
+      return { ...short[segs[0]], id: Number(last) };
+    }
+  }
+  return null;
+}
+function registerResolveTools(server, client2) {
+  server.registerTool(
+    "untappd_resolve",
+    {
+      title: "Resolve an Untappd URL",
+      description: "Parse an untappd.com URL (a beer /b/, brewery /w/, venue /v/, user /user/, or check-in link) into its entity type and id, and name the tool to call next. Pure local parsing \u2014 no network. Read-only.",
+      annotations: toolAnnotations({ title: "Resolve an Untappd URL", readOnly: true, idempotent: true, openWorld: false }),
+      inputSchema: {
+        url: external_exports.string().min(1).describe("An untappd.com URL to resolve")
+      }
+    },
+    async ({ url: url2 }) => {
+      const resolved = parseUntappdUrl(url2);
+      if (!resolved) {
+        throw createHelpfulError(`Not a recognised Untappd entity URL: ${url2}`, {
+          hint: "Expected an untappd.com link like /b/<slug>/<bid>, /w/<slug>/<id>, /v/<slug>/<id>, or /user/<name>."
+        });
+      }
+      return textResult(resolved);
+    }
+  );
+  server.registerTool(
+    "untappd_open_url",
+    {
+      title: "Open an Untappd URL (resolve + fetch)",
+      description: "Resolve an untappd.com URL AND fetch the entity detail in one call \u2014 the convenience combination of untappd_resolve + the matching info tool. Returns { resolved, detail }. Read-only.",
+      annotations: toolAnnotations({ title: "Open an Untappd URL", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        url: external_exports.string().min(1).describe("An untappd.com URL to resolve and fetch")
+      }
+    },
+    async ({ url: url2 }) => {
+      const resolved = parseUntappdUrl(url2);
+      if (!resolved) {
+        throw createHelpfulError(`Not a recognised Untappd entity URL: ${url2}`, {
+          hint: "Expected an untappd.com link like /b/<slug>/<bid>, /w/<slug>/<id>, /v/<slug>/<id>, or /user/<name>."
+        });
+      }
+      const path = resolved.type === "beer" ? `/beer/info/${resolved.id}` : resolved.type === "brewery" ? `/brewery/info/${resolved.id}` : resolved.type === "venue" ? `/venue/info/${resolved.id}` : resolved.type === "checkin" ? `/checkin/view/${resolved.id}` : `/user/info/${encodeURIComponent(resolved.username)}`;
+      const detail = await client2.get(path);
+      return textResult({ resolved, detail });
+    }
+  );
+}
+
 // src/tools/discover.ts
-function registerDiscoverTools(server) {
+function registerDiscoverTools(server, client2) {
   server.registerTool(
     "untappd_trending",
     {
@@ -31749,7 +31978,7 @@ function registerDiscoverTools(server) {
       inputSchema: {}
     },
     async () => {
-      const data = await client.get("/beer/trending");
+      const data = await client2.get("/beer/trending");
       return textResult(data);
     }
   );
@@ -31765,7 +31994,7 @@ function registerDiscoverTools(server) {
       }
     },
     async ({ limit, offset }) => {
-      const data = await client.get("/notifications", { limit, offset });
+      const data = await client2.get("/notifications", { limit, offset });
       return textResult(data);
     }
   );
@@ -31779,19 +32008,81 @@ function registerDiscoverTools(server) {
         lat: external_exports.number().min(-90).max(90).describe("Latitude of the location"),
         lng: external_exports.number().min(-180).max(180).describe("Longitude of the location"),
         limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
-        radius: external_exports.number().int().min(1).max(25).optional().describe("Search radius (default per Untappd)")
+        radius: external_exports.number().int().min(1).max(25).optional().describe("Search radius (default per Untappd)"),
+        compact: external_exports.boolean().optional().describe("Project each check-in to a slim summary to save context (default false)")
       }
     },
-    async ({ lat, lng, limit, radius }) => {
-      const data = await client.get("/thepub/local", { lat, lng, limit, radius });
-      return textResult(data);
+    async ({ lat, lng, limit, radius, compact }) => {
+      const data = await client2.get("/thepub/local", { lat, lng, limit, radius });
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
 
+// src/tools/friends.ts
+var TargetUidSchema = external_exports.number().int().positive().describe("The target user id (uid) \u2014 from a user profile (response.user.uid) or a friends-list item");
+var ACTIONS = [
+  {
+    tool: "untappd_add_friend",
+    path: "request",
+    title: "Send an Untappd friend request",
+    verb: "send a friend request to",
+    detail: "Sends a friend request to another user, who will be notified."
+  },
+  {
+    tool: "untappd_accept_friend",
+    path: "accept",
+    title: "Accept an Untappd friend request",
+    verb: "accept the incoming friend request from",
+    detail: "Accepts an incoming friend request (see untappd_pending_friends for pending uids)."
+  },
+  {
+    tool: "untappd_reject_friend",
+    path: "reject",
+    title: "Reject an Untappd friend request",
+    verb: "reject the incoming friend request from",
+    detail: "Rejects/ignores an incoming friend request (see untappd_pending_friends for pending uids)."
+  },
+  {
+    tool: "untappd_remove_friend",
+    path: "remove",
+    title: "Remove an Untappd friend",
+    verb: "remove your friendship with",
+    detail: "Removes an existing friend, or cancels a friend request you sent."
+  }
+];
+function registerFriendActionTools(server, client2) {
+  for (const action of ACTIONS) {
+    server.registerTool(
+      action.tool,
+      {
+        title: action.title,
+        description: `${action.detail} Acts on YOUR account and affects a real relationship with another person. Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it performs the action. Note: this endpoint path is taken from the Untappd app but is not otherwise independently verified.`,
+        annotations: toolAnnotations({ title: action.title, readOnly: false, idempotent: true, openWorld: true }),
+        inputSchema: {
+          target_uid: TargetUidSchema,
+          confirm: schemaConfirm
+        }
+      },
+      async ({ target_uid, confirm }) => {
+        if (confirm !== true) {
+          return textResult({
+            dryRun: true,
+            action: action.path,
+            target_uid,
+            note: `Dry run \u2014 re-run with confirm: true to ${action.verb} user ${target_uid}.`
+          });
+        }
+        const data = await client2.write("POST", `/friend/${action.path}/${target_uid}`);
+        return textResult({ done: true, action: action.path, target_uid, result: data?.result });
+      }
+    );
+  }
+}
+
 // src/tools/wishlist.ts
 var BidSchema2 = external_exports.number().int().positive().describe("Untappd beer id (bid) \u2014 from untappd_search_beer");
-function registerWishlistTools(server) {
+function registerWishlistTools(server, client2) {
   server.registerTool(
     "untappd_wishlist_add",
     {
@@ -31812,7 +32103,7 @@ function registerWishlistTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to add this beer to your wishlist."
         });
       }
-      const data = await client.write("GET", "/user/wishlist/add", { query: { bid } });
+      const data = await client2.write("GET", "/user/wishlist/add", { query: { bid } });
       return textResult({ added: true, bid, result: data?.result });
     }
   );
@@ -31836,7 +32127,7 @@ function registerWishlistTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to remove this beer from your wishlist."
         });
       }
-      const data = await client.write("GET", "/user/wishlist/delete", { query: { bid } });
+      const data = await client2.write("GET", "/user/wishlist/delete", { query: { bid } });
       return textResult({ removed: true, bid, result: data?.result });
     }
   );
@@ -31857,7 +32148,7 @@ function localTimezone() {
   const gmt_offset = -(/* @__PURE__ */ new Date()).getTimezoneOffset() / 60;
   return { timezone, gmt_offset };
 }
-function registerCheckinTools(server) {
+function registerCheckinTools(server, client2) {
   server.registerTool(
     "untappd_toast",
     {
@@ -31878,7 +32169,7 @@ function registerCheckinTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to toggle your toast on this check-in."
         });
       }
-      const data = await client.write("POST", `/checkin/toast/${checkin_id}`);
+      const data = await client2.write("POST", `/checkin/toast/${checkin_id}`);
       return textResult({ toggled: true, checkin_id, result: data?.result, like_type: data?.like_type });
     }
   );
@@ -31904,7 +32195,7 @@ function registerCheckinTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to post this comment to your Untappd account."
         });
       }
-      const data = await client.write("POST", `/checkin/addcomment/${checkin_id}`, { form: { comment } });
+      const data = await client2.write("POST", `/checkin/addcomment/${checkin_id}`, { form: { comment } });
       return textResult({ posted: true, checkin_id, response: data });
     }
   );
@@ -31928,7 +32219,7 @@ function registerCheckinTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to delete this comment from your Untappd account."
         });
       }
-      const data = await client.write("POST", `/checkin/deletecomment/${comment_id}`);
+      const data = await client2.write("POST", `/checkin/deletecomment/${comment_id}`);
       return textResult({ deleted: true, comment_id, result: data?.result });
     }
   );
@@ -31952,7 +32243,7 @@ function registerCheckinTools(server) {
           note: "Dry run \u2014 re-run with confirm: true to PERMANENTLY delete this check-in. This cannot be undone."
         });
       }
-      const data = await client.write("POST", `/checkin/delete/${checkin_id}`);
+      const data = await client2.write("POST", `/checkin/delete/${checkin_id}`);
       return textResult({ deleted: true, checkin_id, result: data?.result });
     }
   );
@@ -32013,14 +32304,14 @@ function registerCheckinTools(server) {
         if (!existsSync(photo_path)) throw new McpToolError(`Photo file not found: ${photo_path}`);
         blob = await fileBlob(photo_path);
       }
-      const data = await client.write("POST", "/checkin/add", { form });
+      const data = await client2.write("POST", "/checkin/add", { form });
       let photo_attached = false;
       let photo_error;
       if (photo_path !== void 0) {
         if (data?.photo_upload?.url && data.checkin_id) {
           try {
-            await client.putBinary(data.photo_upload.url, blob, PHOTO_CONTENT_TYPES[ext]);
-            await client.write("POST", "/photo/uploadComplete", {
+            await client2.putBinary(data.photo_upload.url, blob, PHOTO_CONTENT_TYPES[ext]);
+            await client2.write("POST", "/photo/uploadComplete", {
               form: { checkin_id: data.checkin_id, destination_url: data.photo_upload.destination_url }
             });
             photo_attached = true;
@@ -32043,7 +32334,7 @@ function registerCheckinTools(server) {
 }
 
 // src/tools/utilities.ts
-function registerUtilityTools(server) {
+function registerUtilityTools(server, client2) {
   server.registerTool(
     "untappd_healthcheck",
     {
@@ -32053,18 +32344,18 @@ function registerUtilityTools(server) {
       inputSchema: {}
     },
     async () => {
-      if (!client.configured) {
+      if (!client2.configured) {
         return textResult({
           ok: false,
           configured: false,
           note: "Untappd credentials are not set. Configure UNTAPPD_USERNAME, UNTAPPD_PASSWORD, UNTAPPD_CLIENT_ID, and UNTAPPD_CLIENT_SECRET."
         });
       }
-      const feed = await client.get("/checkin/recent", { limit: 1 });
+      const feed = await client2.get("/checkin/recent", { limit: 1 });
       return textResult({
         ok: true,
         configured: true,
-        account: client.loginName,
+        account: client2.loginName,
         feed_reachable: feed?.checkins !== void 0,
         note: "Logged in to Untappd and fetched the friend feed successfully."
       });
@@ -32073,19 +32364,22 @@ function registerUtilityTools(server) {
 }
 
 // src/index.ts
+var client = new UntappdClient();
 await runMcp({
   name: "untappd-mcp",
   version: VERSION,
   banner: "[untappd-mcp] This project was developed and is maintained by AI (Claude Opus 4.8). Use at your own discretion.",
   tools: [
-    registerBeerTools,
-    registerBreweryTools,
-    registerVenueTools,
-    registerUserTools,
-    registerFeedTools,
-    registerDiscoverTools,
-    registerWishlistTools,
-    registerCheckinTools,
-    registerUtilityTools
+    (s) => registerBeerTools(s, client),
+    (s) => registerBreweryTools(s, client),
+    (s) => registerVenueTools(s, client),
+    (s) => registerUserTools(s, client),
+    (s) => registerFeedTools(s, client),
+    (s) => registerResolveTools(s, client),
+    (s) => registerDiscoverTools(s, client),
+    (s) => registerFriendActionTools(s, client),
+    (s) => registerWishlistTools(s, client),
+    (s) => registerCheckinTools(s, client),
+    (s) => registerUtilityTools(s, client)
   ]
 });