untappd-mcp 1.0.0 → 1.1.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Untappd — beers, breweries, venues, check-ins, wishlists, and your friend feed",
-    "version": "1.0.0"
+    "version": "1.1.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Untappd",
       "source": "./",
       "description": "MCP server for Untappd — search beers/breweries/venues, read profiles/check-ins/wishlists, and post check-ins, toasts, and comments",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "untappd-mcp",
   "displayName": "Untappd",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Untappd — search beers/breweries/venues, read check-ins and wishlists, and post check-ins, toasts, and comments",
   "author": {
     "name": "Chris Hall",

package/README.md

@@ -57,13 +57,14 @@ Reads: `untappd_search_beer`, `untappd_beer_info`, `untappd_beer_activity`,
 `untappd_search_brewery`, `untappd_brewery_info`, `untappd_brewery_beers`,
 `untappd_search_venue`, `untappd_venue_info`, `untappd_venue_activity`,
 `untappd_user_info`, `untappd_user_checkins`, `untappd_user_wishlist`,
-`untappd_user_beers`, `untappd_user_badges`, `untappd_user_friends`,
-`untappd_activity_feed`, `untappd_checkin_info`, `untappd_trending`,
+`untappd_user_beers`, `untappd_user_badges`, `untappd_user_friends`, `untappd_pending_friends`,
+`untappd_activity_feed`, `untappd_checkin_info`, `untappd_resolve`, `untappd_open_url`, `untappd_user_venues`, `untappd_venue_by_foursquare`, `untappd_trending`,
 `untappd_notifications`, `untappd_local_checkins`, `untappd_healthcheck`.
 
 Writes (confirm-gated — return a dry-run preview unless called with
 `confirm: true`): `untappd_toast`, `untappd_add_comment`, `untappd_delete_comment`, `untappd_checkin`,
-`untappd_wishlist_add`, `untappd_wishlist_remove`, `untappd_delete_checkin`.
+`untappd_wishlist_add`, `untappd_wishlist_remove`, `untappd_delete_checkin`,
+`untappd_add_friend`, `untappd_accept_friend`, `untappd_reject_friend`, `untappd_remove_friend`.
 
 ## Development
 

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,7 +31184,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.0.0";
+var VERSION = "1.1.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -31422,8 +31422,84 @@ 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)");
+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) {
   server.registerTool(
     "untappd_search_beer",
@@ -31435,12 +31511,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 }) => {
+    async ({ query, limit, offset, sort, compact }) => {
       const data = await client.get("/search/beer", { q: query, limit, offset, sort });
-      return textResult(data);
+      return textResult(compact ? compactBeerSearch(data) : data);
     }
   );
   server.registerTool(
@@ -31468,12 +31545,13 @@ 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 }) => {
+    async ({ bid, limit, max_id, compact }) => {
       const data = await client.get(`/beer/checkins/${bid}`, { limit, max_id });
-      return textResult(data);
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
@@ -31567,6 +31645,21 @@ function registerVenueTools(server) {
       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 client.get(`/venue/foursquare_lookup/${encodeURIComponent(foursquare_id)}`);
+      return textResult(data);
+    }
+  );
   server.registerTool(
     "untappd_venue_activity",
     {
@@ -31576,12 +31669,13 @@ 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 }) => {
+    async ({ venue_id, limit, max_id, compact }) => {
       const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
-      return textResult(data);
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
@@ -31623,12 +31717,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 }) => {
+    async ({ username, limit, max_id, compact }) => {
       const data = await client.get(`/user/checkins/${resolveUser(username)}`, { limit, max_id });
-      return textResult(data);
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
   server.registerTool(
@@ -31641,12 +31736,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 }) => {
+    async ({ username, limit, offset, sort, compact }) => {
       const data = await client.get(`/user/wishlist/${resolveUser(username)}`, { limit, offset, sort });
-      return textResult(data);
+      return textResult(compact ? compactWishlist(data) : data);
     }
   );
   server.registerTool(
@@ -31659,12 +31755,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 }) => {
+    async ({ username, limit, offset, sort, compact }) => {
       const data = await client.get(`/user/beers/${resolveUser(username)}`, { limit, offset, sort });
-      return textResult(data);
+      return textResult(compact ? compactUserBeers(data) : data);
     }
   );
   server.registerTool(
@@ -31701,6 +31798,40 @@ function registerUserTools(server) {
       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 client.get(`/user/venues/${resolveUser(username)}`, { 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 client.get("/user/pending", { limit, offset });
+      return textResult(data);
+    }
+  );
 }
 
 // src/tools/feed.ts
@@ -31713,12 +31844,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 }) => {
+    async ({ limit, max_id, compact }) => {
       const data = await client.get("/checkin/recent", { limit, max_id });
-      return textResult(data);
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
   server.registerTool(
@@ -31738,6 +31870,80 @@ function registerFeedTools(server) {
   );
 }
 
+// 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) {
+  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 client.get(path);
+      return textResult({ resolved, detail });
+    }
+  );
+}
+
 // src/tools/discover.ts
 function registerDiscoverTools(server) {
   server.registerTool(
@@ -31779,12 +31985,13 @@ 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 }) => {
+    async ({ lat, lng, limit, radius, compact }) => {
       const data = await client.get("/thepub/local", { lat, lng, limit, radius });
-      return textResult(data);
+      return textResult(compact ? compactCheckins(data) : data);
     }
   );
 }
@@ -31842,6 +32049,67 @@ function registerWishlistTools(server) {
   );
 }
 
+// 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) {
+  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 client.write("POST", `/friend/${action.path}/${target_uid}`);
+        return textResult({ done: true, action: action.path, target_uid, result: data?.result });
+      }
+    );
+  }
+}
+
 // src/tools/checkin.ts
 import { existsSync } from "node:fs";
 import { extname } from "node:path";
@@ -32083,8 +32351,10 @@ await runMcp({
     registerVenueTools,
     registerUserTools,
     registerFeedTools,
+    registerResolveTools,
     registerDiscoverTools,
     registerWishlistTools,
+    registerFriendActionTools,
     registerCheckinTools,
     registerUtilityTools
   ]

package/dist/compact.js

@@ -0,0 +1,90 @@
+// Opt-in slim projections for the fat reverse-engineered list responses. A
+// single check-in record is ~5 KB and a beer search item ~1.2 KB, so a page of
+// 25 is a lot of agent context. These project each item down to the fields an
+// agent usually needs, keyed off DOCUMENTED fields only, and derive nothing it
+// can't. Every projector degrades safely: if the expected `<container>.items`
+// array isn't present (the undocumented API drifted), it warns to stderr and
+// returns the RAW response rather than an empty/wrong projection.
+function asDict(v) {
+    return v && typeof v === 'object' ? v : undefined;
+}
+function count(v) {
+    const d = asDict(v);
+    if (!d)
+        return undefined;
+    return (d.count ?? d.total_count);
+}
+/** Slim a single check-in record. */
+export 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 || undefined,
+        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 || undefined,
+        toasts: count(c.toasts),
+        comments: count(c.comments),
+        has_photo: (count(c.media) ?? 0) > 0,
+    };
+}
+/** The beer fields common to every beer-list item (search, wishlist, distinct). */
+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,
+    };
+}
+/** Slim a single beer-search result item. */
+export function compactBeerResult(item) {
+    const i = asDict(item) ?? {};
+    return { ...beerCore(i), checkin_count: i.checkin_count, have_had: i.have_had };
+}
+/** Slim a single wishlist item (adds when it was wishlisted). */
+export function compactWishlistBeer(item) {
+    const i = asDict(item) ?? {};
+    return { ...beerCore(i), added_at: i.created_at };
+}
+/** Slim a single distinct-beers (user/beers) item — your count, ratings, last had. */
+export function compactUserBeer(item) {
+    const i = asDict(item) ?? {};
+    return {
+        ...beerCore(i),
+        your_count: i.count,
+        your_rating: i.user_auth_rating_score || undefined,
+        global_rating: i.rating_score || undefined,
+        last_had: i.recent_created_at,
+    };
+}
+/**
+ * Project `<container>.items` in a response with `mapFn`, preserving the rest of
+ * the container (pagination etc.). Drift-safe: returns the raw response
+ * unchanged (with a stderr warning) when the array isn't where expected.
+ */
+export 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\n`);
+        return resp;
+    }
+    return { ...r, [container]: { ...box, items: items.map(mapFn) } };
+}
+export const compactCheckins = (resp) => projectItems(resp, 'checkins', compactCheckin);
+export const compactBeerSearch = (resp) => projectItems(resp, 'beers', compactBeerResult);
+export const compactWishlist = (resp) => projectItems(resp, 'beers', compactWishlistBeer);
+export const compactUserBeers = (resp) => projectItems(resp, 'beers', compactUserBeer);

package/dist/index.js

@@ -6,8 +6,10 @@ import { registerBreweryTools } from './tools/brewery.js';
 import { registerVenueTools } from './tools/venue.js';
 import { registerUserTools } from './tools/user.js';
 import { registerFeedTools } from './tools/feed.js';
+import { registerResolveTools } from './tools/resolve.js';
 import { registerDiscoverTools } from './tools/discover.js';
 import { registerWishlistTools } from './tools/wishlist.js';
+import { registerFriendActionTools } from './tools/friends.js';
 import { registerCheckinTools } from './tools/checkin.js';
 import { registerUtilityTools } from './tools/utilities.js';
 // The Untappd client is a module-level singleton (imported by each tool module)
@@ -25,8 +27,10 @@ await runMcp({
         registerVenueTools,
         registerUserTools,
         registerFeedTools,
+        registerResolveTools,
         registerDiscoverTools,
         registerWishlistTools,
+        registerFriendActionTools,
         registerCheckinTools,
         registerUtilityTools,
     ],

package/dist/tools/beer.js

@@ -1,7 +1,12 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
+import { compactBeerSearch, compactCheckins } from '../compact.js';
 const BidSchema = z.number().int().positive().describe('Untappd beer id (bid)');
+const CompactCheckins = z
+    .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)');
 export function registerBeerTools(server) {
     server.registerTool('untappd_search_beer', {
         title: 'Search Untappd beers',
@@ -17,10 +22,14 @@ export function registerBeerTools(server) {
                 .enum(['checkin', 'name', 'count'])
                 .optional()
                 .describe('Sort order: checkin (relevance, default), name, or count'),
+            compact: z
+                .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 }) => {
+    }, async ({ query, limit, offset, sort, compact }) => {
         const data = await client.get('/search/beer', { q: query, limit, offset, sort });
-        return textResult(data);
+        return textResult(compact ? compactBeerSearch(data) : data);
     });
     server.registerTool('untappd_beer_info', {
         title: 'Get Untappd beer detail',
@@ -47,9 +56,10 @@ export function registerBeerTools(server) {
             bid: BidSchema,
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
             max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+            compact: CompactCheckins,
         },
-    }, async ({ bid, limit, max_id }) => {
+    }, async ({ bid, limit, max_id, compact }) => {
         const data = await client.get(`/beer/checkins/${bid}`, { limit, max_id });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
 }

package/dist/tools/discover.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
+import { compactCheckins } from '../compact.js';
 export function registerDiscoverTools(server) {
     server.registerTool('untappd_trending', {
         title: 'Get trending beers',
@@ -35,9 +36,13 @@ export function registerDiscoverTools(server) {
             lng: z.number().min(-180).max(180).describe('Longitude of the location'),
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
             radius: z.number().int().min(1).max(25).optional().describe('Search radius (default per Untappd)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ lat, lng, limit, radius }) => {
+    }, async ({ lat, lng, limit, radius, compact }) => {
         const data = await client.get('/thepub/local', { lat, lng, limit, radius });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
 }

package/dist/tools/feed.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
+import { compactCheckins } from '../compact.js';
 export function registerFeedTools(server) {
     server.registerTool('untappd_activity_feed', {
         title: 'Get Untappd friend activity feed',
@@ -10,10 +11,14 @@ export function registerFeedTools(server) {
         inputSchema: {
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
             max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ limit, max_id }) => {
+    }, async ({ limit, max_id, compact }) => {
         const data = await client.get('/checkin/recent', { limit, max_id });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
     server.registerTool('untappd_checkin_info', {
         title: 'Get Untappd check-in detail',

package/dist/tools/friends.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations, schemaConfirm } from '@chrischall/mcp-utils';
+import { client } from '../client.js';
+// The endpoint PATHS below are confirmed from the Untappd app's own JS bundle
+// (`friend/request`, `friend/accept`, `friend/reject`, `friend/remove`). The
+// HTTP method (POST) mirrors the other captured action-writes (toast/comment),
+// but — unlike the rest of this server's writes — these were NOT live-verified
+// against the API, because doing so would send real friend requests to / alter
+// real relationships with other people. They are confirm-gated so nothing fires
+// without an explicit confirm: true.
+const TargetUidSchema = z
+    .number()
+    .int()
+    .positive()
+    .describe('The target user id (uid) — from a user profile (response.user.uid) or a friends-list item');
+const 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.',
+    },
+];
+export function registerFriendActionTools(server) {
+    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 — re-run with confirm: true to ${action.verb} user ${target_uid}.`,
+                });
+            }
+            const data = await client.write('POST', `/friend/${action.path}/${target_uid}`);
+            return textResult({ done: true, action: action.path, target_uid, result: data?.result });
+        });
+    }
+}

package/dist/tools/resolve.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations, createHelpfulError } from '@chrischall/mcp-utils';
+import { client } from '../client.js';
+/**
+ * Parse an untappd.com URL into its entity type and id. Path shapes (confirmed
+ * from the app + site):
+ *   /b/<slug>/<bid>              → beer
+ *   /w/<slug>/<brewery_id>       → brewery
+ *   /v/<slug>/<venue_id>         → venue
+ *   /user/<username>             → user
+ *   /user/<username>/checkin/<id>→ checkin
+ * Returns null if the URL isn't a recognised Untappd entity URL.
+ */
+export function parseUntappdUrl(input) {
+    let url;
+    try {
+        url = new URL(input.trim());
+    }
+    catch {
+        return null;
+    }
+    if (!/(^|\.)untappd\.com$/i.test(url.hostname))
+        return null;
+    const segs = url.pathname.split('/').filter(Boolean);
+    // /user/<username>/checkin/<id>
+    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' };
+    }
+    // /user/<username>
+    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' },
+    };
+    // /b|w|v/<slug>/<id>  (id is the last numeric segment)
+    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;
+}
+export function registerResolveTools(server) {
+    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 — no network. Read-only.',
+        annotations: toolAnnotations({ title: 'Resolve an Untappd URL', readOnly: true, idempotent: true, openWorld: false }),
+        inputSchema: {
+            url: z.string().min(1).describe('An untappd.com URL to resolve'),
+        },
+    }, async ({ url }) => {
+        const resolved = parseUntappdUrl(url);
+        if (!resolved) {
+            throw createHelpfulError(`Not a recognised Untappd entity URL: ${url}`, {
+                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 — 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: z.string().min(1).describe('An untappd.com URL to resolve and fetch'),
+        },
+    }, async ({ url }) => {
+        const resolved = parseUntappdUrl(url);
+        if (!resolved) {
+            throw createHelpfulError(`Not a recognised Untappd entity URL: ${url}`, {
+                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 client.get(path);
+        return textResult({ resolved, detail });
+    });
+}

package/dist/tools/user.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations, createHelpfulError } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
+import { compactCheckins, compactWishlist, compactUserBeers } from '../compact.js';
 const UsernameArg = z
     .string()
     .min(1)
@@ -39,10 +40,14 @@ export function registerUserTools(server) {
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
             max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ username, limit, max_id }) => {
+    }, async ({ username, limit, max_id, compact }) => {
         const data = await client.get(`/user/checkins/${resolveUser(username)}`, { limit, max_id });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
     server.registerTool('untappd_user_wishlist', {
         title: 'Get Untappd user wishlist',
@@ -56,10 +61,14 @@ export function registerUserTools(server) {
                 .enum(['date', 'name', 'brewery', 'style', 'rating', 'abv'])
                 .optional()
                 .describe('Sort order (default date added, newest first)'),
+            compact: z
+                .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 }) => {
+    }, async ({ username, limit, offset, sort, compact }) => {
         const data = await client.get(`/user/wishlist/${resolveUser(username)}`, { limit, offset, sort });
-        return textResult(data);
+        return textResult(compact ? compactWishlist(data) : data);
     });
     server.registerTool('untappd_user_beers', {
         title: 'Get Untappd distinct beers',
@@ -74,10 +83,14 @@ export function registerUserTools(server) {
                 .enum(['date', 'checkin', 'highest_rated', 'lowest_rated', 'name', 'this_month', 'highest_abv'])
                 .optional()
                 .describe('Sort order (default date, most recent first)'),
+            compact: z
+                .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 }) => {
+    }, async ({ username, limit, offset, sort, compact }) => {
         const data = await client.get(`/user/beers/${resolveUser(username)}`, { limit, offset, sort });
-        return textResult(data);
+        return textResult(compact ? compactUserBeers(data) : data);
     });
     server.registerTool('untappd_user_badges', {
         title: 'Get Untappd user badges',
@@ -105,4 +118,35 @@ export function registerUserTools(server) {
         const data = await client.get(`/user/friends/${resolveUser(username)}`, { 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: z.number().int().min(1).max(50).optional().describe('Max venues (1–50, default 25)'),
+            offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
+            sort: z
+                .enum(['date', 'name', 'checkin', 'highest_rated'])
+                .optional()
+                .describe('Sort order (default most recent)'),
+        },
+    }, async ({ username, limit, offset, sort }) => {
+        const data = await client.get(`/user/venues/${resolveUser(username)}`, { 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 — 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: z.number().int().min(1).max(50).optional().describe('Max requests (1–50, default 25)'),
+            offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
+        },
+    }, async ({ limit, offset }) => {
+        const data = await client.get('/user/pending', { limit, offset });
+        return textResult(data);
+    });
 }

package/dist/tools/venue.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
+import { compactCheckins } from '../compact.js';
 export function registerVenueTools(server) {
     server.registerTool('untappd_search_venue', {
         title: 'Search Untappd venues',
@@ -28,6 +29,18 @@ export function registerVenueTools(server) {
         const data = await client.get(`/venue/info/${venue_id}`, { compact: compact ? 'true' : undefined });
         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: z.string().min(1).describe('Foursquare venue id'),
+        },
+    }, async ({ foursquare_id }) => {
+        const data = await client.get(`/venue/foursquare_lookup/${encodeURIComponent(foursquare_id)}`);
+        return textResult(data);
+    });
     server.registerTool('untappd_venue_activity', {
         title: 'Get recent check-ins at a venue',
         description: 'Get the recent public check-ins at a venue by its id — who was there, what they drank, and their ratings. ' +
@@ -37,9 +50,13 @@ export function registerVenueTools(server) {
             venue_id: z.number().int().positive().describe('Untappd venue id'),
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
             max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ venue_id, limit, max_id }) => {
+    }, async ({ venue_id, limit, max_id, compact }) => {
         const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
 }

package/dist/version.js

@@ -3,4 +3,4 @@
 // json's `extra-files`), and `versionSyncTest` guards that it stays equal to
 // package.json. Import VERSION wherever the version is needed rather than
 // re-declaring it.
-export const VERSION = '1.0.0'; // x-release-please-version
+export const VERSION = '1.1.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "mcpName": "io.github.chrischall/untappd-mcp",
   "description": "Untappd MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/untappd-mcp",
     "source": "github"
   },
-  "version": "1.0.0",
+  "version": "1.1.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "transport": {
         "type": "stdio"
       },