untappd-mcp 1.7.6 → 1.8.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.7.6"
+    "version": "1.8.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.7.6",
+      "version": "1.8.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "untappd-mcp",
   "displayName": "Untappd",
-  "version": "1.7.6",
+  "version": "1.8.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

@@ -31190,7 +31190,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.7.6";
+var VERSION = "1.8.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -32212,6 +32212,108 @@ function registerVenueTools(server, client2) {
       return textResult(data);
     }
   );
+  server.registerTool(
+    "untappd_venue_menu",
+    {
+      title: "Get a venue's verified beer menu (section-paged)",
+      description: "Return a venue's verified beer menu as a flat, compact list of beers. untappd_venue_info returns only the FIRST section of each menu (Untappd defaults the section list to one), so it silently under-reports any venue whose menu spans multiple sections \u2014 e.g. a 23-beer wall that comes back with 2 items. This tool forwards the section_limit / section_offset paging params venue/info echoes back but never receives, walks sections up to a per-call max_pages budget (respecting the ~100 calls/hour limit \u2014 it does NOT loop to completion in one call), and flattens to [{bid, name, brewery, style, abv, price, serving_type, menu, section}]. Like the sync tools it is resumable: when the budget runs out before full coverage it returns another_run_needed:true plus next_section_offset to pass back on the next call. truncated:true means the upstream returned no more sections short of total_count (e.g. it ignored the paging params) \u2014 not resumable. Get an id from untappd_search_venue. Read-only.",
+      annotations: toolAnnotations({ title: "Get a venue's verified beer menu (section-paged)", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        venue_id: external_exports.number().int().positive().describe("Untappd venue id"),
+        menu_id: external_exports.number().int().positive().optional().describe("Restrict to a single menu id (from a prior result). Optional."),
+        section_limit: external_exports.number().int().min(1).max(50).optional().describe("Sections fetched per API call \u2014 page size (default 50)."),
+        section_offset: external_exports.number().int().min(0).optional().describe("Section offset to start from; pass a prior next_section_offset to resume (default 0)."),
+        max_pages: external_exports.number().int().min(1).max(10).optional().describe("API calls to spend THIS run \u2014 page budget, not page size (default 3). Resume with next_section_offset if another_run_needed."),
+        sort: external_exports.string().optional().describe("Menu sort key (e.g. 'publish_order', 'highest_rated'). Optional.")
+      }
+    },
+    async ({ venue_id, menu_id, section_limit, section_offset, max_pages, sort }) => {
+      const pageSize = section_limit ?? 50;
+      const budget = max_pages ?? 3;
+      const startOffset = section_offset ?? 0;
+      let offset = startOffset;
+      const seen = /* @__PURE__ */ new Set();
+      const beers = [];
+      let totalCount = 0;
+      let sawMenu = false;
+      let pagesFetched = 0;
+      let reachedEnd = false;
+      for (let page = 0; page < budget; page++) {
+        const data = await client2.get(`/venue/info/${venue_id}`, {
+          section_limit: pageSize,
+          section_offset: offset,
+          menu_id,
+          sort
+        });
+        pagesFetched++;
+        const vb = data?.venue?.verfied_beers;
+        if (!vb) {
+          reachedEnd = true;
+          break;
+        }
+        sawMenu = true;
+        let added = 0;
+        let matchedItemCount = 0;
+        let sectionsReturned = 0;
+        for (const wrap of vb.items ?? []) {
+          const menu = wrap?.menu;
+          if (!menu) continue;
+          if (menu_id && menu.menu_id !== menu_id) continue;
+          if (typeof menu.total_item_count === "number") matchedItemCount += menu.total_item_count;
+          const sections = menu.sections?.items ?? [];
+          for (const section of sections) {
+            sectionsReturned++;
+            for (const it of section.items ?? []) {
+              const beer = it?.beer;
+              if (!beer || typeof beer.bid !== "number") continue;
+              const key = `${String(menu.menu_id)}:${String(section.section_id)}:${beer.bid}`;
+              if (seen.has(key)) continue;
+              seen.add(key);
+              const sectionName = section.section_name;
+              beers.push({
+                bid: beer.bid,
+                name: beer.beer_name,
+                brewery: it.brewery?.brewery_name,
+                style: beer.beer_style,
+                abv: beer.beer_abv,
+                price: it.price?.value,
+                serving_type: it.serving_type,
+                menu: menu.menu_name,
+                section: typeof sectionName === "string" ? sectionName.trim() : sectionName
+              });
+              added++;
+            }
+          }
+        }
+        totalCount = menu_id ? matchedItemCount : typeof vb.total_count === "number" ? vb.total_count : totalCount;
+        offset += pageSize;
+        if (totalCount > 0 && beers.length >= totalCount) {
+          reachedEnd = true;
+          break;
+        }
+        if (sectionsReturned < pageSize || added === 0) {
+          reachedEnd = true;
+          break;
+        }
+      }
+      if (!sawMenu) {
+        return textResult({ venue_id, total_count: 0, returned: 0, pages_fetched: pagesFetched, another_run_needed: false, truncated: false, beers: [], note: "No verified menu on this venue." });
+      }
+      const covered = totalCount > 0 && beers.length >= totalCount;
+      const another_run_needed = !reachedEnd;
+      const truncated = reachedEnd && !covered && startOffset === 0 && totalCount > 0;
+      return textResult({
+        venue_id,
+        total_count: totalCount,
+        returned: beers.length,
+        pages_fetched: pagesFetched,
+        another_run_needed,
+        ...another_run_needed ? { next_section_offset: offset } : {},
+        truncated,
+        beers
+      });
+    }
+  );
   server.registerTool(
     "untappd_venue_by_foursquare",
     {

package/dist/tools/venue.js

@@ -28,6 +28,139 @@ export function registerVenueTools(server, client) {
         const data = await client.get(`/venue/info/${venue_id}`, { compact: compact ? 'true' : undefined });
         return textResult(data);
     });
+    server.registerTool('untappd_venue_menu', {
+        title: "Get a venue's verified beer menu (section-paged)",
+        description: "Return a venue's verified beer menu as a flat, compact list of beers. untappd_venue_info returns only the FIRST " +
+            'section of each menu (Untappd defaults the section list to one), so it silently under-reports any venue whose menu ' +
+            'spans multiple sections — e.g. a 23-beer wall that comes back with 2 items. This tool forwards the ' +
+            'section_limit / section_offset paging params venue/info echoes back but never receives, walks sections up to a ' +
+            'per-call max_pages budget (respecting the ~100 calls/hour limit — it does NOT loop to completion in one call), and ' +
+            'flattens to [{bid, name, brewery, style, abv, price, serving_type, menu, section}]. Like the sync tools it is ' +
+            'resumable: when the budget runs out before full coverage it returns another_run_needed:true plus next_section_offset ' +
+            'to pass back on the next call. truncated:true means the upstream returned no more sections short of total_count ' +
+            '(e.g. it ignored the paging params) — not resumable. Get an id from untappd_search_venue. Read-only.',
+        annotations: toolAnnotations({ title: "Get a venue's verified beer menu (section-paged)", readOnly: true, idempotent: true, openWorld: true }),
+        inputSchema: {
+            venue_id: z.number().int().positive().describe('Untappd venue id'),
+            menu_id: z.number().int().positive().optional().describe('Restrict to a single menu id (from a prior result). Optional.'),
+            section_limit: z.number().int().min(1).max(50).optional().describe('Sections fetched per API call — page size (default 50).'),
+            section_offset: z.number().int().min(0).optional().describe('Section offset to start from; pass a prior next_section_offset to resume (default 0).'),
+            max_pages: z.number().int().min(1).max(10).optional().describe('API calls to spend THIS run — page budget, not page size (default 3). Resume with next_section_offset if another_run_needed.'),
+            sort: z.string().optional().describe("Menu sort key (e.g. 'publish_order', 'highest_rated'). Optional."),
+        },
+    }, async ({ venue_id, menu_id, section_limit, section_offset, max_pages, sort }) => {
+        // venue/info pages its MENUS with limit/offset, but caps each menu's SECTION
+        // list — echoing `section_limit`/`section_offset` back as accepted params
+        // (the response even carries a `section_offset ` key with a stray trailing
+        // space; the real param name is the clean one the web menu UI sends). We
+        // forward them and walk sections, deduping by menu+section+bid so overlapping
+        // or param-ignoring pages can't double-count. Per CLAUDE.md's rate-limit
+        // design this spends at most `max_pages` API calls per run and hands the
+        // caller next_section_offset to resume, rather than looping to completion.
+        //
+        // Termination is driven by SECTION availability, not a running beer count:
+        // a page that returns fewer sections than we asked for is the end of the
+        // list. That's what makes resuming correct — this tool is stateless across
+        // calls, so on a resumed tail (section_offset > 0) `beers.length` covers
+        // only this run and can never equal the whole-menu total, which would
+        // otherwise mislabel a finished tail as truncated.
+        const pageSize = section_limit ?? 50;
+        const budget = max_pages ?? 3;
+        const startOffset = section_offset ?? 0;
+        let offset = startOffset;
+        const seen = new Set();
+        const beers = [];
+        let totalCount = 0;
+        let sawMenu = false;
+        let pagesFetched = 0;
+        let reachedEnd = false; // hit full coverage, or the section list ran out
+        for (let page = 0; page < budget; page++) {
+            const data = await client.get(`/venue/info/${venue_id}`, {
+                section_limit: pageSize,
+                section_offset: offset,
+                menu_id,
+                sort,
+            });
+            pagesFetched++;
+            const vb = data?.venue?.verfied_beers;
+            if (!vb) {
+                reachedEnd = true; // no menu payload — nothing more to page
+                break;
+            }
+            sawMenu = true;
+            let added = 0;
+            let matchedItemCount = 0;
+            let sectionsReturned = 0;
+            for (const wrap of vb.items ?? []) {
+                const menu = wrap?.menu;
+                if (!menu)
+                    continue;
+                if (menu_id && menu.menu_id !== menu_id)
+                    continue;
+                if (typeof menu.total_item_count === 'number')
+                    matchedItemCount += menu.total_item_count;
+                const sections = menu.sections?.items ?? [];
+                for (const section of sections) {
+                    sectionsReturned++;
+                    for (const it of section.items ?? []) {
+                        const beer = it?.beer;
+                        if (!beer || typeof beer.bid !== 'number')
+                            continue;
+                        const key = `${String(menu.menu_id)}:${String(section.section_id)}:${beer.bid}`;
+                        if (seen.has(key))
+                            continue;
+                        seen.add(key);
+                        const sectionName = section.section_name;
+                        beers.push({
+                            bid: beer.bid,
+                            name: beer.beer_name,
+                            brewery: it.brewery?.brewery_name,
+                            style: beer.beer_style,
+                            abv: beer.beer_abv,
+                            price: it.price?.value,
+                            serving_type: it.serving_type,
+                            menu: menu.menu_name,
+                            section: typeof sectionName === 'string' ? sectionName.trim() : sectionName,
+                        });
+                        added++;
+                    }
+                }
+            }
+            // Coverage target: with a menu_id filter, aim for THAT menu's own item
+            // count — verfied_beers.total_count spans every menu, so a single-menu
+            // slice could never reach it (it would burn the whole page budget and
+            // wrongly report a shortfall). Without a filter, the venue-wide total.
+            totalCount = menu_id ? matchedItemCount : typeof vb.total_count === 'number' ? vb.total_count : totalCount;
+            offset += pageSize;
+            if (totalCount > 0 && beers.length >= totalCount) {
+                reachedEnd = true; // full coverage from this walk
+                break;
+            }
+            if (sectionsReturned < pageSize || added === 0) {
+                reachedEnd = true; // a short (or all-duplicate) page is the end of the section list
+                break;
+            }
+        }
+        if (!sawMenu) {
+            return textResult({ venue_id, total_count: 0, returned: 0, pages_fetched: pagesFetched, another_run_needed: false, truncated: false, beers: [], note: 'No verified menu on this venue.' });
+        }
+        const covered = totalCount > 0 && beers.length >= totalCount;
+        const another_run_needed = !reachedEnd; // stopped only because the page budget ran out mid-list
+        // Only a walk that started at the top of the list can judge a genuine
+        // shortfall as truncated; a resumed tail legitimately returns fewer than
+        // the whole-menu total_count and is not truncated.
+        const truncated = reachedEnd && !covered && startOffset === 0 && totalCount > 0;
+        return textResult({
+            venue_id,
+            total_count: totalCount,
+            returned: beers.length,
+            pages_fetched: pagesFetched,
+            another_run_needed,
+            ...(another_run_needed ? { next_section_offset: offset } : {}),
+            truncated,
+            beers,
+        });
+    });
     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) ' +

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.7.6'; // x-release-please-version
+export const VERSION = '1.8.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "1.7.6",
+  "version": "1.8.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.7.6",
+  "version": "1.8.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "1.7.6",
+      "version": "1.8.0",
       "transport": {
         "type": "stdio"
       },

package/skills/untappd-mcp/SKILL.md

@@ -24,6 +24,12 @@ Run `untappd_healthcheck` to confirm login works.
 - `untappd_search_beer` / `untappd_beer_info` — find beers, then get full detail by bid.
 - `untappd_search_brewery` / `untappd_brewery_info` — breweries.
 - `untappd_search_venue` / `untappd_venue_info` — bars, breweries, restaurants.
+- `untappd_venue_menu` — a venue's verified beer menu, flattened. Use instead of
+  `venue_info` for "what's on tap" — `venue_info` returns only the first section
+  of each menu and under-reports large boards. This pages sections under a
+  per-call `max_pages` budget (like the sync tools) and is resumable: it returns
+  `another_run_needed` + `next_section_offset` when the budget runs out, or
+  `truncated` if the upstream stops returning sections short of coverage.
 - `untappd_user_info` — a user's profile (omit `username` for your own).
 - `untappd_user_checkins` — recent check-ins (page with `max_id`).
 - `untappd_user_wishlist` — wishlist beers.