untappd-mcp 1.10.0 → 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.0"
+    "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.0",
+      "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.0",
+  "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.0";
+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.0'; // 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.0",
+  "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.0",
+  "version": "1.11.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "1.10.0",
+      "version": "1.11.0",
       "transport": {
         "type": "stdio"
       },

package/skills/untappd-mcp/SKILL.md

@@ -40,6 +40,106 @@ Run `untappd_healthcheck` to confirm login works.
 
 Most user tools default `username` to your configured account when omitted.
 
+## Response shape (`view`)
+
+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.
+
+**If you were told to pass `compact: true`, that advice is stale.** It used to
+be true: the projection shipped as an opt-in boolean defaulting to `false`,
+and the tool descriptions asked the caller to please turn it on. An efficiency
+you have to request is one that mostly is not requested — and the caller
+paying for the fat record was the one least able to know a slim rung existed.
+So it flipped. The old parameter is gone; it is not declared anywhere, so zod
+drops the unknown key and the call succeeds. You get the compact rung — right
+answer, wrong reason. **The same silence bites the other way**: `compact:
+false` no longer buys you the full record either. It is dropped identically
+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 — 9 tools.**
+
+- Check-ins (`untappd_activity_feed`, `untappd_user_checkins`,
+  `untappd_beer_activity`, `untappd_venue_activity`,
+  `untappd_local_checkins`): each ~5 KB record becomes `{checkin_id,
+  created_at, user, rating, comment, beer{bid, name, style, abv}, brewery,
+  venue, toasts, comments, has_photo}`. A default page of 25 was upwards of
+  100 KB to learn what someone drank.
+- `untappd_search_beer`: each ~1.2 KB match becomes `{bid, name, style, abv,
+  ibu, brewery, checkin_count, have_had}` — the long `beer_description` and
+  the nested brewery record go.
+- `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
+`compact=true` to Untappd's own endpoint, which drops the embedded
+activity/list blocks server side. **There is no local projection on these**:
+the entity's own fields are byte-identical on both rungs. What compact saves
+is Untappd's embedded blocks — and the bandwidth, not just the context. Do not
+expect a shorter beer record from `untappd_beer_info`; expect the recent-
+activity block to be absent.
+
+The projectors are **drift-safe**. Each keys off a documented container
+(`checkins.items`, `beers.items`); if that array is not where it is expected —
+this is a reverse-engineered API — the projector warns on stderr and returns
+the RAW response rather than an empty or wrong one. A short answer is never
+silently manufactured.
+
+`view: "full"` returns Untappd's response untouched. There is deliberately
+**no `raw` rung**: nothing here re-serialises or normalises a payload, so
+`full` already IS the upstream response and a third value would silently alias
+one that exists.
+
+### 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:
+
+- **The 11 confirm-gated writes** (`untappd_checkin`, `untappd_toast`,
+  `untappd_add_comment`, the two deletes, the wishlist pair, the four friend
+  actions) answer with a dry-run preview or a receipt. Nothing in a receipt is
+  decoration.
+- **`untappd_sync_checkins` / `untappd_sync_user_beers`** answer with sync
+  PROGRESS — pages walked, `another_run_needed`, `backfill_complete`. Slimming
+  a progress report is how you lose the field that says it is not finished.
+- **The five cache tools** (`untappd_cache_has_had`, `…_has_had_many`,
+  `…_not_had`, `untappd_cache_query`, `untappd_top_not_had`) answer from the
+  local SQLite mirror in a shape this repo already wrote — a verdict plus the
+  `freshness` block that says whether a "not found" might be a false negative.
+  There is no upstream payload behind them to project away from.
+- **`untappd_checkin_info`** exists to return the FULL record for one check-in
+  — photos, badges earned, toasts, comments. The ~5 KB the check-in projection
+  removes is exactly what you called this tool to get.
+- **`untappd_venue_menu`** is already its own hand-written projection, with a
+  per-call page budget and a resumable `next_section_offset` contract. A
+  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 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)
 
 Each returns a dry-run preview and makes NO network call unless called with