untappd-mcp 1.6.0 → 1.7.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.6.0"
+    "version": "1.7.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.6.0",
+      "version": "1.7.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

@@ -84,7 +84,7 @@ Writes (confirm-gated — return a dry-run preview unless called with
 
 Check-in cache: `untappd_sync_checkins`, `untappd_sync_user_beers`,
 `untappd_cache_has_had`, `untappd_cache_has_had_many`, `untappd_cache_not_had`,
-`untappd_cache_query`.
+`untappd_cache_query`, `untappd_top_not_had`.
 
 ## Check-in cache
 
@@ -125,6 +125,14 @@ sources (a hit in either counts as had):
   (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_top_not_had` — from a list of `bids`, return the **top N not-had
+  beers ranked by Untappd global rating**, with an optional `style` filter (the
+  "what should I order off this tap list?" tool). Not-had filtering is
+  cache-only; beer ratings come from a metadata cache (`beer_meta`) that's seeded
+  opportunistically by `untappd_beer_info` / `untappd_search_beer` and topped up
+  via `beer/info` only on a cache miss or entries older than 30 days — capped at
+  `api_budget` calls/run (default 25), returning `partial: true` /
+  `another_run_needed: true` when more are needed.
 - `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

@@ -72,6 +72,10 @@ Query tools (has-had ones consult BOTH sources — a hit in either = had):
   case-insensitive `beer_name` substring.
 - `untappd_cache_has_had_many` — batch had/not-had for a list of `bids`.
 - `untappd_cache_not_had` — from a list of `bids`, the ones NOT had.
+- `untappd_top_not_had` — from a list of `bids`, the top N NOT-had beers by
+  Untappd rating, with an optional `style` filter ("what should I order off this
+  tap list?"). Uses a `beer_meta` cache; calls `beer/info` only on miss/stale,
+  capped at `api_budget` per run (partial/another_run_needed when exceeded).
 - `untappd_cache_query` — filter cached check-ins by brewery, style, `min_rating`,
   venue, and date range.