untappd-mcp 2.5.1 → 2.6.0

package/dist/tools/user.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { foodMeta } from './hints.js';
 import { createHelpfulError, minifiedResult, resolveView, toolAnnotations, viewParam, viewResult } from '@chrischall/mcp-utils';
 import { compactCheckins, compactWishlist, compactUserBeers, UNTAPPD_VIEWS, upstreamCompact } from '../compact.js';
 const UsernameArg = z
@@ -43,6 +44,7 @@ export function registerUserTools(server, client) {
         description: "Get an Untappd user's profile: bio, location, total check-ins, distinct beers, badges, and stats. " +
             'Omit username for your own account. Read-only.',
         annotations: toolAnnotations({ title: 'Get Untappd user profile', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             view: viewParam(UNTAPPD_VIEWS, { note: 'compact also asks Untappd for its own slim record, dropping the embedded activity/list blocks; \'full\' returns everything.' }),
@@ -59,6 +61,7 @@ export function registerUserTools(server, client) {
             'any other user Untappd returns just the ~50 most recent check-ins and ignores max_id — use untappd_user_beers ' +
             '(has had) or untappd_user_venues (has been) for their full history. Omit username for your own. Read-only.',
         annotations: toolAnnotations({ title: 'Get Untappd user check-ins', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
@@ -74,6 +77,7 @@ export function registerUserTools(server, client) {
         title: 'Get Untappd user wishlist',
         description: "Get the beers on a user's wishlist. Supports sorting and paging. Omit username for your own account. Read-only.",
         annotations: toolAnnotations({ title: 'Get Untappd user wishlist', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup', { aliases: ['wishlist', 'beers to try'] }),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max beers (1–50, default 25)'),
@@ -94,6 +98,7 @@ export function registerUserTools(server, client) {
         description: "Get the distinct (unique) beers a user has ever checked in, with their rating and check-in count per beer. " +
             'Supports sorting and paging. Omit username for your own account. Read-only.',
         annotations: toolAnnotations({ title: 'Get Untappd distinct beers', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max beers (1–50, default 25)'),
@@ -113,6 +118,7 @@ export function registerUserTools(server, client) {
         title: 'Get Untappd user badges',
         description: "Get the badges a user has earned, most recent first. Omit username for your own account. Read-only.",
         annotations: toolAnnotations({ title: 'Get Untappd user badges', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max badges (1–50, default 25)'),
@@ -126,6 +132,7 @@ export function registerUserTools(server, client) {
         title: 'Get Untappd user friends',
         description: "Get a user's friend list. Omit username for your own account. Read-only.",
         annotations: toolAnnotations({ title: 'Get Untappd user friends', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max friends (1–50, default 25)'),
@@ -142,6 +149,7 @@ export function registerUserTools(server, client) {
             'other users). Untappd returns at most 25 venues per page whatever limit you ask for — advance by the ' +
             "returned pagination offset. Omit username for your own account. Read-only.",
         annotations: toolAnnotations({ title: 'Get venues a user has checked in at', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             username: UsernameArg,
             limit: z.number().int().min(1).max(50).optional().describe('Max venues (1–50; Untappd caps a page at 25)'),
@@ -166,6 +174,7 @@ export function registerUserTools(server, client) {
         description: 'Get the incoming friend requests waiting on YOUR account — the users who have requested to be your ' +
             'friend. Read-only.',
         annotations: toolAnnotations({ title: 'Get your pending friend requests', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             limit: z.number().int().min(1).max(50).optional().describe('Max requests (1–50, default 25)'),
             offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),

package/dist/tools/venue.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { foodMeta } from './hints.js';
 import { minifiedResult, resolveView, toolAnnotations, viewParam, viewResult } from '@chrischall/mcp-utils';
 import { compactCheckins, UNTAPPD_VIEWS, upstreamCompact } from '../compact.js';
 import { walkVenueMenu } from '../menu/venue-menu.js';
@@ -19,6 +20,7 @@ export function registerVenueTools(server, client, cacheProvider) {
         description: 'Search Untappd for venues (bars, breweries, restaurants) by name. Returns matches with their venue id, ' +
             'category, and location. Feed a venue id into untappd_venue_info for full detail. Read-only.',
         annotations: toolAnnotations({ title: 'Search Untappd venues', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup', { aliases: ['bar', 'pub', 'taproom', 'brewpub'] }),
         inputSchema: z.object({
             query: z.string().min(1).describe('Venue name to search for'),
             limit: z.number().int().min(1).max(50).optional().describe('Max results (1–50, default 25)'),
@@ -32,6 +34,7 @@ export function registerVenueTools(server, client, cacheProvider) {
         description: 'Get full detail for a venue by its Untappd venue id: category, address, contact, rating, total check-ins, ' +
             'and — on view:"full" — top beers and recent activity. Get an id from untappd_search_venue. Read-only.',
         annotations: toolAnnotations({ title: 'Get Untappd venue detail', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             venue_id: z.number().int().positive().describe('Untappd venue id'),
             view: viewParam(UNTAPPD_VIEWS, { note: 'compact also asks Untappd for its own slim record, dropping the embedded activity/list blocks; "full" returns everything.' }),
@@ -58,6 +61,7 @@ export function registerVenueTools(server, client, cacheProvider) {
             'with untappd_favorite_add; default your account) — applied on read, so never stale. 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 }),
+        _meta: foodMeta('lookup', { aliases: ['on tap', 'tap list', 'beer menu'] }),
         inputSchema: z.object({
             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.'),
@@ -137,6 +141,7 @@ export function registerVenueTools(server, client, cacheProvider) {
         description: 'Resolve a Foursquare venue id to its Untappd venue. Useful to turn a foursquare_id (e.g. from a check-in) ' +
             'into an Untappd venue you can pass to untappd_venue_info / untappd_venue_activity. Read-only.',
         annotations: toolAnnotations({ title: 'Look up an Untappd venue by Foursquare id', readOnly: true, idempotent: true, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             foursquare_id: z.string().min(1).describe('Foursquare venue id'),
         }),
@@ -150,6 +155,7 @@ export function registerVenueTools(server, client, cacheProvider) {
             'Page backwards with max_id (the pagination.max_id from a prior call). Cached locally for ' + TTL_HOURS + ' hours ' +
             'per venue + limit + max_id (cache.hit, fetched_at, expires_at); refresh:true re-fetches. Read-only.',
         annotations: toolAnnotations({ title: 'Get recent check-ins at a venue', readOnly: true, idempotent: false, openWorld: true }),
+        _meta: foodMeta('lookup'),
         inputSchema: z.object({
             venue_id: z.number().int().positive().describe('Untappd venue id'),
             limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),

package/dist/tools/wishlist.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { foodMeta } from './hints.js';
 import { confirmTokenParam, minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { CONFIRM_FLOW, confirmWrite } from './confirm.js';
 const BidSchema = z.number().int().positive().describe('Untappd beer id (bid) — from untappd_search_beer');
@@ -7,6 +8,7 @@ export function registerWishlistTools(server, client) {
         title: 'Add a beer to your wishlist',
         description: `Add a beer to YOUR Untappd wishlist by its bid. Writes to your account. ${CONFIRM_FLOW}`,
         annotations: toolAnnotations({ title: 'Add a beer to your wishlist', readOnly: false, idempotent: true, openWorld: true, destructive: false }),
+        _meta: foodMeta('change', { aliases: ['want to try', 'save a beer'] }),
         inputSchema: z.object({
             bid: BidSchema,
             confirmToken: confirmTokenParam,
@@ -33,6 +35,7 @@ export function registerWishlistTools(server, client) {
         title: 'Remove a beer from your wishlist',
         description: `Remove a beer from YOUR Untappd wishlist by its bid. Writes to your account. ${CONFIRM_FLOW}`,
         annotations: toolAnnotations({ title: 'Remove a beer from your wishlist', readOnly: false, idempotent: true, openWorld: true, destructive: false }),
+        _meta: foodMeta('change'),
         inputSchema: z.object({
             bid: BidSchema,
             confirmToken: confirmTokenParam,

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

package/package.json

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

package/skills/untappd-mcp/SKILL.md

@@ -73,6 +73,12 @@ 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.
 
+`untappd_activity_feed` also takes a third rung, `view: "brief"`: one line per
+check-in, `<user>: <beer> (<brewery>) at <venue> — <ISO date | no date> —
+<rated N | not rated>`, each at most 120 characters. It is the shape a
+context-group host reads aloud (below); use it when you only need to say what
+friends have been drinking.
+
 Compact comes in two tiers here, and they are not the same thing:
 
 **A hand-written field projection — 9 tools.**
@@ -245,3 +251,25 @@ owner-only (dir `0700`, file `0600`).
 Every cache read returns a `freshness` block reporting each source's completeness
 separately (plus `coverage_complete` and a `caveat` when incomplete), so you can
 flag a "not found" as possibly a false negative until the relevant sync finishes.
+
+## In context groups
+
+On an mcp-host connector this server is a member of the **food** group (every
+tool but `untappd_healthcheck` carries a `_meta.mint` hint with
+`domain: "food"`). Its one canonical read is **`untappd_activity_feed`** for
+**what's new** — the friend feed, answered with `view: "brief"`. It takes no
+subject and no date range: Untappd has no listable set of the person's own
+subjects (no children, properties or accounts to fan out over), so the group
+asks it once, not once per person. Nothing here answers what's due or what's
+on; every other read is a `lookup` (`untappd_notifications` is a non-canonical
+what's-new), and the writes are `send` (toast, comment, friend request),
+`change` (check-in, deletes, wishlist, favourites, friend accept/reject/remove)
+or `other` (the cache syncs and the pickers, which refresh the local cache as
+they read).
+
+A compound ask looks like *"what's new with food — any new reservations, and
+what have my friends been drinking?"*: the host answers the Untappd half from
+the feed's brief lines beside the group's other members. This server calls the
+Untappd API directly, so it never answers "needs your browser open"; if it is
+not configured, the group reports it as unable to answer and
+`untappd_healthcheck` says which credential is missing.