untappd-mcp 1.10.1 → 1.11.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.10.1"
+    "version": "1.11.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.10.1",
+      "version": "1.11.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "untappd-mcp",
   "displayName": "Untappd",
-  "version": "1.10.1",
+  "version": "1.11.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/dist/bundle.js

@@ -35675,7 +35675,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.10.1";
+var VERSION = "1.11.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -36005,6 +36005,18 @@ function compactUserBeer(item) {
     last_had: i.recent_created_at
   };
 }
+function compactBreweryBeer(item) {
+  const i = asDict(item) ?? {};
+  const beer = asDict(i.beer) ?? {};
+  return {
+    ...beerCore(i),
+    rating: beer.rating_score,
+    rating_count: beer.rating_count,
+    checkin_count: i.total_count,
+    have_had: i.has_had,
+    your_count: i.total_user_count
+  };
+}
 function projectItems(resp, container, mapFn) {
   const r = asDict(resp);
   const box = asDict(r?.[container]);
@@ -36020,6 +36032,12 @@ 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);
+function compactBreweryBeers(resp) {
+  const projected = projectItems(resp, "beers", compactBreweryBeer);
+  if (projected === resp) return resp;
+  const { sorting_options: _dropped, ...rest } = projected;
+  return rest;
+}
 var UNTAPPD_VIEWS = ["compact", "full"];
 function upstreamCompact(view) {
   return view === "compact" ? "true" : void 0;
@@ -36673,12 +36691,21 @@ function registerBreweryTools(server, client2) {
         brewery_id: external_exports.number().int().positive().describe("Untappd brewery id"),
         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(["name", "style", "abv", "rating", "count"]).optional().describe("Sort order (default by popularity)")
+        sort: external_exports.enum(["name", "style", "abv", "rating", "count"]).optional().describe("Sort order (default by popularity)"),
+        view: viewParam(UNTAPPD_VIEWS, {
+          note: `compact keeps each beer's identity, rating and counts and drops the description, label URLs and the copy of this brewery repeated on every row; "full" returns Untappd's whole page.`
+        })
       }
     },
-    async ({ brewery_id, limit, offset, sort }) => {
+    // Unlike its `/brewery/info` sibling above, this rung is NOT forwarded to
+    // Untappd: `/brewery/beer_list/` is not one of the endpoints documented to
+    // honour an upstream `compact`, and sending an unverified parameter to see
+    // what happens is not a rung. The projection is entirely ours and is
+    // grounded on a live capture — see `compactBreweryBeer`.
+    async ({ brewery_id, limit, offset, sort, view }) => {
+      const v = resolveView(view, UNTAPPD_VIEWS);
       const data = await client2.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
-      return minifiedResult(data);
+      return viewResult(v, v === "compact" ? compactBreweryBeers(data) : data);
     }
   );
 }

package/dist/compact.js

@@ -75,6 +75,36 @@ export function compactUserBeer(item) {
         last_had: i.recent_created_at,
     };
 }
+/**
+ * Slim one `/brewery/beer_list/` item.
+ *
+ * This endpoint needs its OWN projector rather than reusing
+ * {@link compactBeerResult}, and the reason is easy to miss: the item shape IS
+ * `{beer:{…}, brewery:{…}}`-wrapped, so `beerCore` fits perfectly — but the two
+ * fields the search projector adds on top of it are named differently here.
+ * `/search/beer` says `checkin_count` / `have_had`; `/brewery/beer_list/` says
+ * `total_count` / `has_had`. Reusing the search projector would therefore have
+ * emitted a page of records carrying two silent `undefined`s — a beer with no
+ * check-ins that you have never had — and `projectItems`' drift guard cannot
+ * catch that, because the CONTAINER is exactly where it expects it to be.
+ * Established against a live capture of brewery 1142, not by inference.
+ *
+ * Rating rides along because the tool's own description promises "per-beer
+ * rating and check-in counts"; a compact rung that dropped them would
+ * contradict the thing the caller was told they were getting.
+ */
+export function compactBreweryBeer(item) {
+    const i = asDict(item) ?? {};
+    const beer = asDict(i.beer) ?? {};
+    return {
+        ...beerCore(i),
+        rating: beer.rating_score,
+        rating_count: beer.rating_count,
+        checkin_count: i.total_count,
+        have_had: i.has_had,
+        your_count: i.total_user_count,
+    };
+}
 /**
  * Project `<container>.items` in a response with `mapFn`, preserving the rest of
  * the container (pagination etc.). Drift-safe: returns the raw response
@@ -94,6 +124,22 @@ export const compactCheckins = (resp) => projectItems(resp, 'checkins', compactC
 export const compactBeerSearch = (resp) => projectItems(resp, 'beers', compactBeerResult);
 export const compactWishlist = (resp) => projectItems(resp, 'beers', compactWishlistBeer);
 export const compactUserBeers = (resp) => projectItems(resp, 'beers', compactUserBeer);
+/**
+ * Project a brewery beer list, and drop `sorting_options` with it.
+ *
+ * `sorting_options` is 16 `{sort_key, sort_name}` pairs of UI chrome repeated on
+ * every page. The tool's `sort` parameter is already a closed enum on its input
+ * schema, so the list tells a caller nothing they were not handed with the
+ * schema — it is pure duplication of a contract they already hold.
+ */
+export function compactBreweryBeers(resp) {
+    const projected = projectItems(resp, 'beers', compactBreweryBeer);
+    // projectItems returns the SAME object on drift; don't reshape that.
+    if (projected === resp)
+        return resp;
+    const { sorting_options: _dropped, ...rest } = projected;
+    return rest;
+}
 /**
  * The rungs this server honours (`@chrischall/mcp-utils`' `view` vocabulary,
  * and `chrischall/workflows` `docs/fleet-conventions.md`, "Response shape").

package/dist/tools/brewery.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { minifiedResult, resolveView, toolAnnotations, viewParam, viewResult } from '@chrischall/mcp-utils';
-import { UNTAPPD_VIEWS, upstreamCompact } from '../compact.js';
+import { UNTAPPD_VIEWS, compactBreweryBeers, upstreamCompact } from '../compact.js';
 export function registerBreweryTools(server, client) {
     server.registerTool('untappd_search_brewery', {
         title: 'Search Untappd breweries',
@@ -43,9 +43,19 @@ export function registerBreweryTools(server, client) {
                 .enum(['name', 'style', 'abv', 'rating', 'count'])
                 .optional()
                 .describe('Sort order (default by popularity)'),
+            view: viewParam(UNTAPPD_VIEWS, {
+                note: 'compact keeps each beer\'s identity, rating and counts and drops the description, label URLs and the copy of this brewery repeated on every row; "full" returns Untappd\'s whole page.',
+            }),
         },
-    }, async ({ brewery_id, limit, offset, sort }) => {
+    }, 
+    // Unlike its `/brewery/info` sibling above, this rung is NOT forwarded to
+    // Untappd: `/brewery/beer_list/` is not one of the endpoints documented to
+    // honour an upstream `compact`, and sending an unverified parameter to see
+    // what happens is not a rung. The projection is entirely ours and is
+    // grounded on a live capture — see `compactBreweryBeer`.
+    async ({ brewery_id, limit, offset, sort, view }) => {
+        const v = resolveView(view, UNTAPPD_VIEWS);
         const data = await client.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
-        return minifiedResult(data);
+        return viewResult(v, v === 'compact' ? compactBreweryBeers(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.10.1'; // x-release-please-version
+export const VERSION = '1.11.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "1.10.1",
+  "version": "1.11.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.10.1",
+  "version": "1.11.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "transport": {
         "type": "stdio"
       },

package/skills/untappd-mcp/SKILL.md

@@ -42,7 +42,7 @@ Most user tools default `username` to your configured account when omitted.
 
 ## Response shape (`view`)
 
-Twelve of this server's 45 tools take `view: "compact" | "full"`, and
+Thirteen of this server's 45 tools take `view: "compact" | "full"`, and
 **`compact` is the DEFAULT** — the slim rung is what you get without asking
 for it.
 
@@ -59,7 +59,7 @@ and you still get compact. `view: "full"` is the only way back.
 
 Compact comes in two tiers here, and they are not the same thing:
 
-**A hand-written field projection — 8 tools.**
+**A hand-written field projection — 9 tools.**
 
 - Check-ins (`untappd_activity_feed`, `untappd_user_checkins`,
   `untappd_beer_activity`, `untappd_venue_activity`,
@@ -73,6 +73,16 @@ Compact comes in two tiers here, and they are not the same thing:
 - `untappd_user_wishlist`: the same beer core plus `added_at`.
 - `untappd_user_beers`: the same beer core plus `your_count`, `your_rating`,
   `global_rating`, `last_had`.
+- `untappd_brewery_beers`: the same beer core plus `rating`, `rating_count`,
+  `checkin_count`, `have_had`, `your_count`. It has its **own** projector
+  rather than sharing `untappd_search_beer`'s, and the reason is a trap worth
+  knowing: the item shape is identically `{beer:{…}}`-wrapped, but this
+  endpoint spells the two surrounding fields `total_count` / `has_had` where
+  `/search/beer` says `checkin_count` / `have_had`. Sharing the projector
+  would return beers with no check-ins that you had never had, and the
+  drift guard would not fire — the container was where it was expected. Per
+  page it also drops `sorting_options` and the copy of the same brewery
+  object repeated on every row.
 
 **An upstream request for less — 4 tools.** `untappd_user_info`,
 `untappd_beer_info`, `untappd_brewery_info` and `untappd_venue_info` forward
@@ -94,7 +104,7 @@ silently manufactured.
 `full` already IS the upstream response and a third value would silently alias
 one that exists.
 
-### The 33 tools without `view`
+### The 32 tools without `view`
 
 Each for its own reason — and none of them will tell you it ignored the
 parameter, because an undeclared key is dropped by zod without a warning:
@@ -119,15 +129,16 @@ parameter, because an undeclared key is dropped by zod without a warning:
   second projection on top of it would fight the first.
 - **`untappd_resolve`, `untappd_open_url`, `untappd_healthcheck`** return a
   verdict or a diagnostic.
-- **The remaining ten reads** — `untappd_trending`, `untappd_notifications`,
-  `untappd_brewery_beers`, `untappd_search_brewery`, `untappd_search_venue`,
-  `untappd_user_badges`, `untappd_user_friends`, `untappd_user_venues`,
-  `untappd_pending_friends`, `untappd_venue_by_foursquare` — hand back
-  Untappd's payload as it arrived. No projector has been written for their
-  shapes, so there is no rung to ask for and **no slim option exists**.
-  `untappd_brewery_beers` is the one worth budgeting for: it returns a beer
-  list, which is the shape the beer projectors handle, but it is not wired to
-  one — a 50-beer page arrives as 50 full records.
+- **The remaining nine reads** — `untappd_trending`, `untappd_notifications`,
+  `untappd_search_brewery`, `untappd_search_venue`, `untappd_user_badges`,
+  `untappd_user_friends`, `untappd_user_venues`, `untappd_pending_friends`,
+  `untappd_venue_by_foursquare` — hand back Untappd's payload as it arrived.
+  No projector has been written for their shapes, so there is no rung to ask
+  for and **no slim option exists**.
+
+  `untappd_brewery_beers` **used to be tenth on this list and no longer is**
+  (#161) — it takes a `view` now, and its field shape is documented with the
+  other projections above.
 
 ## Write tools (confirm-gated — these post to your public account)