untappd-mcp 1.4.0 → 1.5.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.4.0"
+    "version": "1.5.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.4.0",
+      "version": "1.5.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

@@ -83,7 +83,7 @@ Writes (confirm-gated — return a dry-run preview unless called with
 `untappd_add_friend`, `untappd_accept_friend`, `untappd_reject_friend`, `untappd_remove_friend`.
 
 Check-in cache: `untappd_sync_checkins`, `untappd_cache_has_had`,
-`untappd_cache_has_had_many`, `untappd_cache_query`.
+`untappd_cache_has_had_many`, `untappd_cache_not_had`, `untappd_cache_query`.
 
 ## Check-in cache
 
@@ -114,6 +114,8 @@ connector — the tools and behaviour are identical either way.
      date, and the matching check-ins.
    - `untappd_cache_has_had_many` — cross-check a whole list of `bids` in one
      call (e.g. a venue's menu) → had/not-had per beer.
+   - `untappd_cache_not_had` — given a list of `bids`, return just the ones the
+     user has **not** had — the "what's new to me on this menu?" filter.
    - `untappd_cache_query` — filter cached check-ins by brewery, style,
      `min_rating`, venue, and/or date range, with sorting and a limit.
 

package/SKILL.md

@@ -68,6 +68,8 @@ on the remote connector it's a per-user Durable Object. Same tools either way.
   case-insensitive `beer_name` substring.
 - `untappd_cache_has_had_many` — batch had/not-had for a list of `bids` in one
   call (venue-menu cross-check).
+- `untappd_cache_not_had` — given a list of `bids`, return only the ones the user
+  has NOT had ("what's new to me on this menu?").
 - `untappd_cache_query` — filter cached check-ins by brewery, style, `min_rating`,
   venue, and date range, with sort + limit.
 

package/dist/bundle.js

@@ -31184,7 +31184,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.4.0";
+var VERSION = "1.5.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -32938,6 +32938,40 @@ function registerCacheTools(server, client2, cacheProvider) {
       });
     }
   );
+  server.registerTool(
+    "untappd_cache_not_had",
+    {
+      title: "From a list of beers, return the ones a user has NOT had",
+      description: 'Given a list of beer ids, return only the ones the user has NOT checked in \u2014 the "what here is new to me?" filter for a venue menu, a brewery lineup, or a festival list. Reads the cache only, NO API call. Returns the not-had bids (plus the had bids and counts) and cache freshness. Run untappd_sync_checkins first; if the cache is incomplete the freshness caveat flags that a "not had" may be a false negative.',
+      annotations: toolAnnotations({ title: "From a list of beers, return the ones a user has NOT had", readOnly: true, idempotent: true, openWorld: false }),
+      inputSchema: {
+        username: UsernameArg2,
+        bids: external_exports.array(external_exports.number().int().positive()).min(1).max(500).describe("Candidate beer ids to filter (1\u2013500)")
+      }
+    },
+    async ({ username, bids }) => {
+      const user = resolveUser2(username, client2.loginName);
+      const cache = cacheProvider();
+      const seen = /* @__PURE__ */ new Set();
+      const notHad = [];
+      const had = [];
+      for (const bid of bids) {
+        if (seen.has(bid)) continue;
+        seen.add(bid);
+        if ((await cache.hasHad(user, { bid })).had) had.push(bid);
+        else notHad.push(bid);
+      }
+      return textResult({
+        username: user,
+        checked: seen.size,
+        not_had_count: notHad.length,
+        had_count: had.length,
+        not_had: notHad,
+        had,
+        freshness: await freshness(cache, user)
+      });
+    }
+  );
   server.registerTool(
     "untappd_cache_query",
     {

package/dist/tools/cache.js

@@ -137,6 +137,44 @@ export function registerCacheTools(server, client, cacheProvider) {
             freshness: await freshness(cache, user),
         });
     });
+    server.registerTool('untappd_cache_not_had', {
+        title: 'From a list of beers, return the ones a user has NOT had',
+        description: 'Given a list of beer ids, return only the ones the user has NOT checked in — the "what here is new to me?" ' +
+            'filter for a venue menu, a brewery lineup, or a festival list. Reads the cache only, NO API call. Returns ' +
+            'the not-had bids (plus the had bids and counts) and cache freshness. Run untappd_sync_checkins first; if the ' +
+            'cache is incomplete the freshness caveat flags that a "not had" may be a false negative.',
+        annotations: toolAnnotations({ title: 'From a list of beers, return the ones a user has NOT had', readOnly: true, idempotent: true, openWorld: false }),
+        inputSchema: {
+            username: UsernameArg,
+            bids: z.array(z.number().int().positive()).min(1).max(500).describe('Candidate beer ids to filter (1–500)'),
+        },
+    }, async ({ username, bids }) => {
+        const user = resolveUser(username, client.loginName);
+        const cache = cacheProvider();
+        // De-dupe the input, preserving first-seen order, so a repeated bid is
+        // looked up once and reported once.
+        const seen = new Set();
+        const notHad = [];
+        const had = [];
+        for (const bid of bids) {
+            if (seen.has(bid))
+                continue;
+            seen.add(bid);
+            if ((await cache.hasHad(user, { bid })).had)
+                had.push(bid);
+            else
+                notHad.push(bid);
+        }
+        return textResult({
+            username: user,
+            checked: seen.size,
+            not_had_count: notHad.length,
+            had_count: had.length,
+            not_had: notHad,
+            had,
+            freshness: await freshness(cache, user),
+        });
+    });
     server.registerTool('untappd_cache_query', {
         title: 'Query cached check-ins with filters',
         description: "Query a user's cached check-ins by brewery, style, minimum rating, venue, and/or date range, with sorting " +

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "1.4.0",
+  "version": "1.5.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.4.0",
+  "version": "1.5.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "1.4.0",
+      "version": "1.5.0",
       "transport": {
         "type": "stdio"
       },