untappd-mcp 0.0.0 → 1.0.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": "0.0.0"
+    "version": "1.0.0"
   },
   "plugins": [
     {
@@ -15,14 +15,20 @@
       "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": "0.0.0",
+      "version": "1.0.0",
       "author": {
         "name": "Chris Hall"
       },
       "homepage": "https://github.com/chrischall/untappd-mcp",
       "repository": "https://github.com/chrischall/untappd-mcp",
       "license": "MIT",
-      "keywords": ["untappd", "beer", "breweries", "checkins", "mcp"],
+      "keywords": [
+        "untappd",
+        "beer",
+        "breweries",
+        "checkins",
+        "mcp"
+      ],
       "category": "lifestyle"
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "untappd-mcp",
   "displayName": "Untappd",
-  "version": "0.0.0",
+  "version": "1.0.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",
@@ -10,7 +10,13 @@
   "homepage": "https://github.com/chrischall/untappd-mcp",
   "repository": "https://github.com/chrischall/untappd-mcp",
   "license": "MIT",
-  "keywords": ["untappd", "beer", "breweries", "checkins", "mcp"],
+  "keywords": [
+    "untappd",
+    "beer",
+    "breweries",
+    "checkins",
+    "mcp"
+  ],
   "skills": "./SKILL.md",
   "mcp": "./.mcp.json"
 }

package/README.md

@@ -53,14 +53,17 @@ Keep these values private; do not commit them.
 
 ## Tools
 
-Reads: `untappd_search_beer`, `untappd_beer_info`, `untappd_search_brewery`,
-`untappd_brewery_info`, `untappd_search_venue`, `untappd_venue_info`,
+Reads: `untappd_search_beer`, `untappd_beer_info`, `untappd_beer_activity`,
+`untappd_search_brewery`, `untappd_brewery_info`, `untappd_brewery_beers`,
+`untappd_search_venue`, `untappd_venue_info`, `untappd_venue_activity`,
 `untappd_user_info`, `untappd_user_checkins`, `untappd_user_wishlist`,
 `untappd_user_beers`, `untappd_user_badges`, `untappd_user_friends`,
-`untappd_activity_feed`, `untappd_checkin_info`, `untappd_healthcheck`.
+`untappd_activity_feed`, `untappd_checkin_info`, `untappd_trending`,
+`untappd_notifications`, `untappd_local_checkins`, `untappd_healthcheck`.
 
 Writes (confirm-gated — return a dry-run preview unless called with
-`confirm: true`): `untappd_toast`, `untappd_add_comment`, `untappd_checkin`.
+`confirm: true`): `untappd_toast`, `untappd_add_comment`, `untappd_delete_comment`, `untappd_checkin`,
+`untappd_wishlist_add`, `untappd_wishlist_remove`, `untappd_delete_checkin`.
 
 ## Development
 

package/dist/bundle.js

@@ -31073,6 +31073,11 @@ function truncateErrorMessage(text, max = DEFAULT_ERROR_MESSAGE_MAX) {
     return redacted;
   return `${redacted.slice(0, max)}\u2026 [truncated]`;
 }
+function messageOf(err) {
+  if (err instanceof Error)
+    return err.message;
+  return String(err);
+}
 
 // node_modules/@chrischall/mcp-utils/dist/response/index.js
 function textResult(data) {
@@ -31111,6 +31116,21 @@ async function loadDotenvSafely(opts = {}) {
   }
 }
 
+// node_modules/@chrischall/mcp-utils/dist/fs/index.js
+import { openAsBlob } from "node:fs";
+async function fileBlob(path, opts = {}) {
+  let blob;
+  try {
+    blob = await openAsBlob(path, opts.type !== void 0 ? { type: opts.type } : void 0);
+  } catch {
+    throw new Error(`Cannot read file for upload: ${path}`);
+  }
+  if (opts.maxBytes !== void 0 && blob.size > opts.maxBytes) {
+    throw new Error(`${opts.label ?? "File"} is ${blob.size} bytes, over the ${opts.maxBytes}-byte limit: ${path}`);
+  }
+  return blob;
+}
+
 // node_modules/@chrischall/mcp-utils/dist/http/index.js
 function buildQueryString(params) {
   const parts = [];
@@ -31164,7 +31184,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "0.0.0";
+var VERSION = "1.0.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -31387,6 +31407,18 @@ var UntappdClient = class {
   async write(method, path, opts = {}) {
     return this.request(method, path, { ...opts, auth: "bearer" });
   }
+  /**
+   * Raw binary PUT to an arbitrary URL — used for the presigned-S3 photo upload,
+   * whose URL already carries its own auth query params, so NO Untappd token is
+   * attached. `body` should be a file-backed Blob (streamed, not heap-buffered).
+   */
+  async putBinary(url2, body, contentType) {
+    const res = await this.send("PUT", url2, { headers: { "Content-Type": contentType }, body });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new McpToolError(formatApiError(res.status, "PUT", url2.split("?")[0], text, { service: `${SERVICE} photo upload` }));
+    }
+  }
 };
 var client = new UntappdClient();
 
@@ -31427,6 +31459,23 @@ function registerBeerTools(server) {
       return textResult(data);
     }
   );
+  server.registerTool(
+    "untappd_beer_activity",
+    {
+      title: "Get recent check-ins for a beer",
+      description: "Get the recent public check-ins for a beer by its bid \u2014 who drank it, their rating, comment, and venue. Page backwards with max_id (the pagination.max_id from a prior call). Read-only.",
+      annotations: toolAnnotations({ title: "Get recent check-ins for a beer", readOnly: true, idempotent: false, openWorld: true }),
+      inputSchema: {
+        bid: BidSchema,
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+      }
+    },
+    async ({ bid, limit, max_id }) => {
+      const data = await client.get(`/beer/checkins/${bid}`, { limit, max_id });
+      return textResult(data);
+    }
+  );
 }
 
 // src/tools/brewery.ts
@@ -31464,6 +31513,24 @@ function registerBreweryTools(server) {
       return textResult(data);
     }
   );
+  server.registerTool(
+    "untappd_brewery_beers",
+    {
+      title: "Get a brewery's beer list",
+      description: "Get the beers a brewery makes, by brewery id, with per-beer rating and check-in counts. Supports sorting and paging. Get an id from untappd_search_brewery. Read-only.",
+      annotations: toolAnnotations({ title: "Get a brewery's beer list", readOnly: true, idempotent: true, openWorld: true }),
+      inputSchema: {
+        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)")
+      }
+    },
+    async ({ brewery_id, limit, offset, sort }) => {
+      const data = await client.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
+      return textResult(data);
+    }
+  );
 }
 
 // src/tools/venue.ts
@@ -31500,6 +31567,23 @@ function registerVenueTools(server) {
       return textResult(data);
     }
   );
+  server.registerTool(
+    "untappd_venue_activity",
+    {
+      title: "Get recent check-ins at a venue",
+      description: "Get the recent public check-ins at a venue by its id \u2014 who was there, what they drank, and their ratings. Page backwards with max_id (the pagination.max_id from a prior call). Read-only.",
+      annotations: toolAnnotations({ title: "Get recent check-ins at a venue", readOnly: true, idempotent: false, openWorld: true }),
+      inputSchema: {
+        venue_id: external_exports.number().int().positive().describe("Untappd venue id"),
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
+        max_id: external_exports.number().int().positive().optional().describe("Return check-ins older than this id (for paging)")
+      }
+    },
+    async ({ venue_id, limit, max_id }) => {
+      const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
+      return textResult(data);
+    }
+  );
 }
 
 // src/tools/user.ts
@@ -31654,8 +31738,119 @@ function registerFeedTools(server) {
   );
 }
 
+// src/tools/discover.ts
+function registerDiscoverTools(server) {
+  server.registerTool(
+    "untappd_trending",
+    {
+      title: "Get trending beers",
+      description: "Get the beers trending on Untappd right now, split into macro (big/widely-available) and micro (craft/independent) lists. Read-only.",
+      annotations: toolAnnotations({ title: "Get trending beers", readOnly: true, idempotent: false, openWorld: true }),
+      inputSchema: {}
+    },
+    async () => {
+      const data = await client.get("/beer/trending");
+      return textResult(data);
+    }
+  );
+  server.registerTool(
+    "untappd_notifications",
+    {
+      title: "Get your Untappd notifications",
+      description: "Get your Untappd notifications \u2014 toasts, comments, friend requests, and badges earned on YOUR account, plus news items. Read-only.",
+      annotations: toolAnnotations({ title: "Get your Untappd notifications", readOnly: true, idempotent: false, openWorld: true }),
+      inputSchema: {
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max notifications (1\u201350, default 25)"),
+        offset: external_exports.number().int().min(0).optional().describe("Result offset for paging (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      const data = await client.get("/notifications", { limit, offset });
+      return textResult(data);
+    }
+  );
+  server.registerTool(
+    "untappd_local_checkins",
+    {
+      title: "Get nearby Untappd check-ins",
+      description: "Get recent check-ins near a location (lat/lng) \u2014 what people are drinking nearby right now. Optionally widen the search radius. Read-only.",
+      annotations: toolAnnotations({ title: "Get nearby Untappd check-ins", readOnly: true, idempotent: false, openWorld: true }),
+      inputSchema: {
+        lat: external_exports.number().min(-90).max(90).describe("Latitude of the location"),
+        lng: external_exports.number().min(-180).max(180).describe("Longitude of the location"),
+        limit: external_exports.number().int().min(1).max(50).optional().describe("Max check-ins (1\u201350, default 25)"),
+        radius: external_exports.number().int().min(1).max(25).optional().describe("Search radius (default per Untappd)")
+      }
+    },
+    async ({ lat, lng, limit, radius }) => {
+      const data = await client.get("/thepub/local", { lat, lng, limit, radius });
+      return textResult(data);
+    }
+  );
+}
+
+// src/tools/wishlist.ts
+var BidSchema2 = external_exports.number().int().positive().describe("Untappd beer id (bid) \u2014 from untappd_search_beer");
+function registerWishlistTools(server) {
+  server.registerTool(
+    "untappd_wishlist_add",
+    {
+      title: "Add a beer to your wishlist",
+      description: "Add a beer to YOUR Untappd wishlist by its bid. Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it adds. Writes to your account.",
+      annotations: toolAnnotations({ title: "Add a beer to your wishlist", readOnly: false, idempotent: true, openWorld: true }),
+      inputSchema: {
+        bid: BidSchema2,
+        confirm: schemaConfirm
+      }
+    },
+    async ({ bid, confirm }) => {
+      if (confirm !== true) {
+        return textResult({
+          dryRun: true,
+          action: "wishlist_add",
+          bid,
+          note: "Dry run \u2014 re-run with confirm: true to add this beer to your wishlist."
+        });
+      }
+      const data = await client.write("GET", "/user/wishlist/add", { query: { bid } });
+      return textResult({ added: true, bid, result: data?.result });
+    }
+  );
+  server.registerTool(
+    "untappd_wishlist_remove",
+    {
+      title: "Remove a beer from your wishlist",
+      description: "Remove a beer from YOUR Untappd wishlist by its bid. Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it removes. Writes to your account.",
+      annotations: toolAnnotations({ title: "Remove a beer from your wishlist", readOnly: false, idempotent: true, openWorld: true }),
+      inputSchema: {
+        bid: BidSchema2,
+        confirm: schemaConfirm
+      }
+    },
+    async ({ bid, confirm }) => {
+      if (confirm !== true) {
+        return textResult({
+          dryRun: true,
+          action: "wishlist_remove",
+          bid,
+          note: "Dry run \u2014 re-run with confirm: true to remove this beer from your wishlist."
+        });
+      }
+      const data = await client.write("GET", "/user/wishlist/delete", { query: { bid } });
+      return textResult({ removed: true, bid, result: data?.result });
+    }
+  );
+}
+
 // src/tools/checkin.ts
+import { existsSync } from "node:fs";
+import { extname } from "node:path";
 var CheckinIdSchema = external_exports.number().int().positive().describe("Untappd check-in id");
+var PHOTO_CONTENT_TYPES = { jpg: "image/jpeg", png: "image/png" };
+function photoExt(path) {
+  const ext = extname(path).slice(1).toLowerCase();
+  return ext === "jpeg" ? "jpg" : ext;
+}
 var RatingSchema = external_exports.number().min(0).max(5).refine((r) => Math.round(r * 4) === r * 4, { message: "rating must be a multiple of 0.25" });
 function localTimezone() {
   const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
@@ -31713,25 +31908,83 @@ function registerCheckinTools(server) {
       return textResult({ posted: true, checkin_id, response: data });
     }
   );
+  server.registerTool(
+    "untappd_delete_comment",
+    {
+      title: "Delete a comment from an Untappd check-in",
+      description: "Delete one of YOUR comments by its comment id (the id from a check-in's comments list). Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it deletes.",
+      annotations: toolAnnotations({ title: "Delete a comment from an Untappd check-in", readOnly: false, idempotent: true, openWorld: true }),
+      inputSchema: {
+        comment_id: external_exports.number().int().positive().describe("Untappd comment id (from a check-in's comments.items)"),
+        confirm: schemaConfirm
+      }
+    },
+    async ({ comment_id, confirm }) => {
+      if (confirm !== true) {
+        return textResult({
+          dryRun: true,
+          action: "delete_comment",
+          comment_id,
+          note: "Dry run \u2014 re-run with confirm: true to delete this comment from your Untappd account."
+        });
+      }
+      const data = await client.write("POST", `/checkin/deletecomment/${comment_id}`);
+      return textResult({ deleted: true, comment_id, result: data?.result });
+    }
+  );
+  server.registerTool(
+    "untappd_delete_checkin",
+    {
+      title: "Delete an Untappd check-in",
+      description: "Permanently delete one of YOUR check-ins by its id. This is destructive and cannot be undone. Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it deletes.",
+      annotations: toolAnnotations({ title: "Delete an Untappd check-in", readOnly: false, idempotent: true, openWorld: true }),
+      inputSchema: {
+        checkin_id: CheckinIdSchema,
+        confirm: schemaConfirm
+      }
+    },
+    async ({ checkin_id, confirm }) => {
+      if (confirm !== true) {
+        return textResult({
+          dryRun: true,
+          action: "delete_checkin",
+          checkin_id,
+          note: "Dry run \u2014 re-run with confirm: true to PERMANENTLY delete this check-in. This cannot be undone."
+        });
+      }
+      const data = await client.write("POST", `/checkin/delete/${checkin_id}`);
+      return textResult({ deleted: true, checkin_id, result: data?.result });
+    }
+  );
   server.registerTool(
     "untappd_checkin",
     {
       title: "Check in a beer on Untappd",
-      description: "Post a NEW beer check-in to YOUR Untappd account \u2014 this publishes to your public feed. Provide the beer id (bid) from untappd_search_beer; optionally a rating (0\u20135 in 0.25 steps), a shout (comment), and a venue via foursquare_id (from a venue result). Without confirm: true it returns a dry-run preview of the exact fields and makes NO network call; with confirm: true it posts. Photo attachment is not supported.",
+      description: "Post a NEW beer check-in to YOUR Untappd account \u2014 this publishes to your public feed. Provide the beer id (bid) from untappd_search_beer; optionally a rating (0\u20135 in 0.25 steps), a shout (comment), a venue via foursquare_id, and a local photo via photo_path (JPEG/PNG). Without confirm: true it returns a dry-run preview of the exact fields and makes NO network call; with confirm: true it posts.",
       annotations: toolAnnotations({ title: "Check in a beer on Untappd", readOnly: false, idempotent: false, openWorld: true }),
       inputSchema: {
         bid: external_exports.number().int().positive().describe("Untappd beer id to check in (from untappd_search_beer)"),
         rating: RatingSchema.optional().describe("Rating 0\u20135 in 0.25 increments (omit for no rating)"),
         shout: external_exports.string().max(2e3).optional().describe("Optional shout / comment text for the check-in"),
         foursquare_id: external_exports.string().optional().describe("Optional Foursquare venue id to tag the check-in location"),
+        photo_path: external_exports.string().optional().describe("Optional path to a local JPEG/PNG photo to attach to the check-in"),
         geolat: external_exports.number().optional().describe("Optional latitude of the check-in"),
         geolng: external_exports.number().optional().describe("Optional longitude of the check-in"),
         container_id: external_exports.number().int().optional().describe("Optional serving container id (e.g. 1 = draft, 2 = bottle, 3 = can)"),
         confirm: schemaConfirm
       }
     },
-    async ({ bid, rating, shout, foursquare_id, geolat, geolng, container_id, confirm }) => {
+    async ({ bid, rating, shout, foursquare_id, photo_path, geolat, geolng, container_id, confirm }) => {
       const { timezone, gmt_offset } = localTimezone();
+      let ext;
+      if (photo_path !== void 0) {
+        ext = photoExt(photo_path);
+        if (!(ext in PHOTO_CONTENT_TYPES)) {
+          throw createHelpfulError(`Unsupported photo type "${ext || "(none)"}".`, {
+            hint: "Attach a .jpg, .jpeg, or .png file."
+          });
+        }
+      }
       const form = {
         bid,
         rating: rating !== void 0 ? rating.toFixed(2) : void 0,
@@ -31742,7 +31995,8 @@ function registerCheckinTools(server) {
         container_id,
         timezone,
         gmt_offset,
-        is_photo: "false",
+        is_photo: photo_path !== void 0 ? "true" : "false",
+        photo_file_ext: photo_path !== void 0 ? ext : void 0,
         platform: "ios"
       };
       if (confirm !== true) {
@@ -31750,11 +32004,40 @@ function registerCheckinTools(server) {
           dryRun: true,
           action: "checkin",
           form,
+          photo: photo_path !== void 0 ? { path: photo_path, note: "will be uploaded after the check-in is created" } : void 0,
           note: "Dry run \u2014 re-run with confirm: true to POST this check-in to your public Untappd feed."
         });
       }
+      let blob;
+      if (photo_path !== void 0) {
+        if (!existsSync(photo_path)) throw new McpToolError(`Photo file not found: ${photo_path}`);
+        blob = await fileBlob(photo_path);
+      }
       const data = await client.write("POST", "/checkin/add", { form });
-      return textResult({ checked_in: true, checkin_id: data?.checkin_id, response: data });
+      let photo_attached = false;
+      let photo_error;
+      if (photo_path !== void 0) {
+        if (data?.photo_upload?.url && data.checkin_id) {
+          try {
+            await client.putBinary(data.photo_upload.url, blob, PHOTO_CONTENT_TYPES[ext]);
+            await client.write("POST", "/photo/uploadComplete", {
+              form: { checkin_id: data.checkin_id, destination_url: data.photo_upload.destination_url }
+            });
+            photo_attached = true;
+          } catch (e) {
+            photo_error = `Check-in ${data.checkin_id} was created, but attaching the photo failed: ${messageOf(e)}. Retry attaching, or remove it with untappd_delete_checkin.`;
+          }
+        } else {
+          photo_error = `Check-in ${data?.checkin_id} was created, but Untappd returned no photo upload URL, so no photo was attached.`;
+        }
+      }
+      return textResult({
+        checked_in: true,
+        checkin_id: data?.checkin_id,
+        photo_attached,
+        ...photo_error ? { photo_error } : {},
+        response: data
+      });
     }
   );
 }
@@ -31800,6 +32083,8 @@ await runMcp({
     registerVenueTools,
     registerUserTools,
     registerFeedTools,
+    registerDiscoverTools,
+    registerWishlistTools,
     registerCheckinTools,
     registerUtilityTools
   ]

package/dist/client.js

@@ -242,6 +242,18 @@ export class UntappdClient {
     async write(method, path, opts = {}) {
         return this.request(method, path, { ...opts, auth: 'bearer' });
     }
+    /**
+     * Raw binary PUT to an arbitrary URL — used for the presigned-S3 photo upload,
+     * whose URL already carries its own auth query params, so NO Untappd token is
+     * attached. `body` should be a file-backed Blob (streamed, not heap-buffered).
+     */
+    async putBinary(url, body, contentType) {
+        const res = await this.send('PUT', url, { headers: { 'Content-Type': contentType }, body });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new McpToolError(formatApiError(res.status, 'PUT', url.split('?')[0], text, { service: `${SERVICE} photo upload` }));
+        }
+    }
 }
 /**
  * Module-level singleton shared by every tool module. Constructing it here (not

package/dist/index.js

@@ -6,6 +6,8 @@ import { registerBreweryTools } from './tools/brewery.js';
 import { registerVenueTools } from './tools/venue.js';
 import { registerUserTools } from './tools/user.js';
 import { registerFeedTools } from './tools/feed.js';
+import { registerDiscoverTools } from './tools/discover.js';
+import { registerWishlistTools } from './tools/wishlist.js';
 import { registerCheckinTools } from './tools/checkin.js';
 import { registerUtilityTools } from './tools/utilities.js';
 // The Untappd client is a module-level singleton (imported by each tool module)
@@ -23,6 +25,8 @@ await runMcp({
         registerVenueTools,
         registerUserTools,
         registerFeedTools,
+        registerDiscoverTools,
+        registerWishlistTools,
         registerCheckinTools,
         registerUtilityTools,
     ],

package/dist/tools/beer.js

@@ -38,4 +38,18 @@ export function registerBeerTools(server) {
         const data = await client.get(`/beer/info/${bid}`, { compact: compact ? 'true' : undefined });
         return textResult(data);
     });
+    server.registerTool('untappd_beer_activity', {
+        title: 'Get recent check-ins for a beer',
+        description: 'Get the recent public check-ins for a beer by its bid — who drank it, their rating, comment, and venue. ' +
+            'Page backwards with max_id (the pagination.max_id from a prior call). Read-only.',
+        annotations: toolAnnotations({ title: 'Get recent check-ins for a beer', readOnly: true, idempotent: false, openWorld: true }),
+        inputSchema: {
+            bid: BidSchema,
+            limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
+            max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+        },
+    }, async ({ bid, limit, max_id }) => {
+        const data = await client.get(`/beer/checkins/${bid}`, { limit, max_id });
+        return textResult(data);
+    });
 }

package/dist/tools/brewery.js

@@ -29,4 +29,22 @@ export function registerBreweryTools(server) {
         const data = await client.get(`/brewery/info/${brewery_id}`, { compact: compact ? 'true' : undefined });
         return textResult(data);
     });
+    server.registerTool('untappd_brewery_beers', {
+        title: "Get a brewery's beer list",
+        description: 'Get the beers a brewery makes, by brewery id, with per-beer rating and check-in counts. Supports sorting ' +
+            'and paging. Get an id from untappd_search_brewery. Read-only.',
+        annotations: toolAnnotations({ title: "Get a brewery's beer list", readOnly: true, idempotent: true, openWorld: true }),
+        inputSchema: {
+            brewery_id: z.number().int().positive().describe('Untappd brewery id'),
+            limit: z.number().int().min(1).max(50).optional().describe('Max beers (1–50, default 25)'),
+            offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
+            sort: z
+                .enum(['name', 'style', 'abv', 'rating', 'count'])
+                .optional()
+                .describe('Sort order (default by popularity)'),
+        },
+    }, async ({ brewery_id, limit, offset, sort }) => {
+        const data = await client.get(`/brewery/beer_list/${brewery_id}`, { limit, offset, sort });
+        return textResult(data);
+    });
 }

package/dist/tools/checkin.js

@@ -1,7 +1,16 @@
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
 import { z } from 'zod';
-import { textResult, toolAnnotations, schemaConfirm } from '@chrischall/mcp-utils';
+import { textResult, toolAnnotations, schemaConfirm, fileBlob, McpToolError, createHelpfulError, messageOf } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
 const CheckinIdSchema = z.number().int().positive().describe('Untappd check-in id');
+// Keyed by the NORMALISED extension that photoExt() returns (jpeg → jpg), so
+// there is no dead `jpeg` entry.
+const PHOTO_CONTENT_TYPES = { jpg: 'image/jpeg', png: 'image/png' };
+function photoExt(path) {
+    const ext = extname(path).slice(1).toLowerCase();
+    return ext === 'jpeg' ? 'jpg' : ext;
+}
 // Untappd ratings are 0–5 in 0.25 increments; 0 (or omitted) means no rating.
 const RatingSchema = z
     .number()
@@ -60,18 +69,61 @@ export function registerCheckinTools(server) {
         const data = await client.write('POST', `/checkin/addcomment/${checkin_id}`, { form: { comment } });
         return textResult({ posted: true, checkin_id, response: data });
     });
+    server.registerTool('untappd_delete_comment', {
+        title: 'Delete a comment from an Untappd check-in',
+        description: 'Delete one of YOUR comments by its comment id (the id from a check-in\'s comments list). Without ' +
+            'confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it deletes.',
+        annotations: toolAnnotations({ title: 'Delete a comment from an Untappd check-in', readOnly: false, idempotent: true, openWorld: true }),
+        inputSchema: {
+            comment_id: z.number().int().positive().describe('Untappd comment id (from a check-in\'s comments.items)'),
+            confirm: schemaConfirm,
+        },
+    }, async ({ comment_id, confirm }) => {
+        if (confirm !== true) {
+            return textResult({
+                dryRun: true,
+                action: 'delete_comment',
+                comment_id,
+                note: 'Dry run — re-run with confirm: true to delete this comment from your Untappd account.',
+            });
+        }
+        const data = await client.write('POST', `/checkin/deletecomment/${comment_id}`);
+        return textResult({ deleted: true, comment_id, result: data?.result });
+    });
+    server.registerTool('untappd_delete_checkin', {
+        title: 'Delete an Untappd check-in',
+        description: 'Permanently delete one of YOUR check-ins by its id. This is destructive and cannot be undone. Without ' +
+            'confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it deletes.',
+        annotations: toolAnnotations({ title: 'Delete an Untappd check-in', readOnly: false, idempotent: true, openWorld: true }),
+        inputSchema: {
+            checkin_id: CheckinIdSchema,
+            confirm: schemaConfirm,
+        },
+    }, async ({ checkin_id, confirm }) => {
+        if (confirm !== true) {
+            return textResult({
+                dryRun: true,
+                action: 'delete_checkin',
+                checkin_id,
+                note: 'Dry run — re-run with confirm: true to PERMANENTLY delete this check-in. This cannot be undone.',
+            });
+        }
+        const data = await client.write('POST', `/checkin/delete/${checkin_id}`);
+        return textResult({ deleted: true, checkin_id, result: data?.result });
+    });
     server.registerTool('untappd_checkin', {
         title: 'Check in a beer on Untappd',
         description: 'Post a NEW beer check-in to YOUR Untappd account — this publishes to your public feed. Provide the beer id ' +
-            '(bid) from untappd_search_beer; optionally a rating (0–5 in 0.25 steps), a shout (comment), and a venue via ' +
-            'foursquare_id (from a venue result). Without confirm: true it returns a dry-run preview of the exact fields ' +
-            'and makes NO network call; with confirm: true it posts. Photo attachment is not supported.',
+            '(bid) from untappd_search_beer; optionally a rating (0–5 in 0.25 steps), a shout (comment), a venue via ' +
+            'foursquare_id, and a local photo via photo_path (JPEG/PNG). Without confirm: true it returns a dry-run ' +
+            'preview of the exact fields and makes NO network call; with confirm: true it posts.',
         annotations: toolAnnotations({ title: 'Check in a beer on Untappd', readOnly: false, idempotent: false, openWorld: true }),
         inputSchema: {
             bid: z.number().int().positive().describe('Untappd beer id to check in (from untappd_search_beer)'),
             rating: RatingSchema.optional().describe('Rating 0–5 in 0.25 increments (omit for no rating)'),
             shout: z.string().max(2000).optional().describe('Optional shout / comment text for the check-in'),
             foursquare_id: z.string().optional().describe('Optional Foursquare venue id to tag the check-in location'),
+            photo_path: z.string().optional().describe('Optional path to a local JPEG/PNG photo to attach to the check-in'),
             geolat: z.number().optional().describe('Optional latitude of the check-in'),
             geolng: z.number().optional().describe('Optional longitude of the check-in'),
             container_id: z
@@ -81,8 +133,17 @@ export function registerCheckinTools(server) {
                 .describe('Optional serving container id (e.g. 1 = draft, 2 = bottle, 3 = can)'),
             confirm: schemaConfirm,
         },
-    }, async ({ bid, rating, shout, foursquare_id, geolat, geolng, container_id, confirm }) => {
+    }, async ({ bid, rating, shout, foursquare_id, photo_path, geolat, geolng, container_id, confirm }) => {
         const { timezone, gmt_offset } = localTimezone();
+        let ext;
+        if (photo_path !== undefined) {
+            ext = photoExt(photo_path);
+            if (!(ext in PHOTO_CONTENT_TYPES)) {
+                throw createHelpfulError(`Unsupported photo type "${ext || '(none)'}".`, {
+                    hint: 'Attach a .jpg, .jpeg, or .png file.',
+                });
+            }
+        }
         const form = {
             bid,
             rating: rating !== undefined ? rating.toFixed(2) : undefined,
@@ -93,7 +154,8 @@ export function registerCheckinTools(server) {
             container_id,
             timezone,
             gmt_offset,
-            is_photo: 'false',
+            is_photo: photo_path !== undefined ? 'true' : 'false',
+            photo_file_ext: photo_path !== undefined ? ext : undefined,
             platform: 'ios',
         };
         if (confirm !== true) {
@@ -101,10 +163,48 @@ export function registerCheckinTools(server) {
                 dryRun: true,
                 action: 'checkin',
                 form,
+                photo: photo_path !== undefined ? { path: photo_path, note: 'will be uploaded after the check-in is created' } : undefined,
                 note: 'Dry run — re-run with confirm: true to POST this check-in to your public Untappd feed.',
             });
         }
+        // Open the photo BEFORE creating the check-in, so a missing/unreadable
+        // file fails fast without leaving an orphaned photo-less check-in behind.
+        let blob;
+        if (photo_path !== undefined) {
+            if (!existsSync(photo_path))
+                throw new McpToolError(`Photo file not found: ${photo_path}`);
+            blob = await fileBlob(photo_path); // file-backed, streamed — not heap-buffered
+        }
         const data = await client.write('POST', '/checkin/add', { form });
-        return textResult({ checked_in: true, checkin_id: data?.checkin_id, response: data });
+        // Photo is a follow-up S3 upload keyed to the returned checkin_id, then an
+        // uploadComplete call. The check-in already exists at this point, so a
+        // photo failure is surfaced explicitly (photo_error) rather than thrown —
+        // never silently dropped.
+        let photo_attached = false;
+        let photo_error;
+        if (photo_path !== undefined) {
+            if (data?.photo_upload?.url && data.checkin_id) {
+                try {
+                    await client.putBinary(data.photo_upload.url, blob, PHOTO_CONTENT_TYPES[ext]);
+                    await client.write('POST', '/photo/uploadComplete', {
+                        form: { checkin_id: data.checkin_id, destination_url: data.photo_upload.destination_url },
+                    });
+                    photo_attached = true;
+                }
+                catch (e) {
+                    photo_error = `Check-in ${data.checkin_id} was created, but attaching the photo failed: ${messageOf(e)}. Retry attaching, or remove it with untappd_delete_checkin.`;
+                }
+            }
+            else {
+                photo_error = `Check-in ${data?.checkin_id} was created, but Untappd returned no photo upload URL, so no photo was attached.`;
+            }
+        }
+        return textResult({
+            checked_in: true,
+            checkin_id: data?.checkin_id,
+            photo_attached,
+            ...(photo_error ? { photo_error } : {}),
+            response: data,
+        });
     });
 }

package/dist/tools/discover.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
+import { client } from '../client.js';
+export function registerDiscoverTools(server) {
+    server.registerTool('untappd_trending', {
+        title: 'Get trending beers',
+        description: 'Get the beers trending on Untappd right now, split into macro (big/widely-available) and micro ' +
+            '(craft/independent) lists. Read-only.',
+        annotations: toolAnnotations({ title: 'Get trending beers', readOnly: true, idempotent: false, openWorld: true }),
+        inputSchema: {},
+    }, async () => {
+        const data = await client.get('/beer/trending');
+        return textResult(data);
+    });
+    server.registerTool('untappd_notifications', {
+        title: 'Get your Untappd notifications',
+        description: 'Get your Untappd notifications — toasts, comments, friend requests, and badges earned on YOUR account, ' +
+            'plus news items. Read-only.',
+        annotations: toolAnnotations({ title: 'Get your Untappd notifications', readOnly: true, idempotent: false, openWorld: true }),
+        inputSchema: {
+            limit: z.number().int().min(1).max(50).optional().describe('Max notifications (1–50, default 25)'),
+            offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
+        },
+    }, async ({ limit, offset }) => {
+        const data = await client.get('/notifications', { limit, offset });
+        return textResult(data);
+    });
+    server.registerTool('untappd_local_checkins', {
+        title: 'Get nearby Untappd check-ins',
+        description: 'Get recent check-ins near a location (lat/lng) — what people are drinking nearby right now. Optionally ' +
+            'widen the search radius. Read-only.',
+        annotations: toolAnnotations({ title: 'Get nearby Untappd check-ins', readOnly: true, idempotent: false, openWorld: true }),
+        inputSchema: {
+            lat: z.number().min(-90).max(90).describe('Latitude of the location'),
+            lng: z.number().min(-180).max(180).describe('Longitude of the location'),
+            limit: z.number().int().min(1).max(50).optional().describe('Max check-ins (1–50, default 25)'),
+            radius: z.number().int().min(1).max(25).optional().describe('Search radius (default per Untappd)'),
+        },
+    }, async ({ lat, lng, limit, radius }) => {
+        const data = await client.get('/thepub/local', { lat, lng, limit, radius });
+        return textResult(data);
+    });
+}

package/dist/tools/venue.js

@@ -28,4 +28,18 @@ export function registerVenueTools(server) {
         const data = await client.get(`/venue/info/${venue_id}`, { compact: compact ? 'true' : undefined });
         return textResult(data);
     });
+    server.registerTool('untappd_venue_activity', {
+        title: 'Get recent check-ins at a venue',
+        description: 'Get the recent public check-ins at a venue by its id — who was there, what they drank, and their ratings. ' +
+            'Page backwards with max_id (the pagination.max_id from a prior call). Read-only.',
+        annotations: toolAnnotations({ title: 'Get recent check-ins at a venue', readOnly: true, idempotent: false, openWorld: true }),
+        inputSchema: {
+            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)'),
+            max_id: z.number().int().positive().optional().describe('Return check-ins older than this id (for paging)'),
+        },
+    }, async ({ venue_id, limit, max_id }) => {
+        const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
+        return textResult(data);
+    });
 }

package/dist/tools/wishlist.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations, schemaConfirm } from '@chrischall/mcp-utils';
+import { client } from '../client.js';
+const BidSchema = z.number().int().positive().describe('Untappd beer id (bid) — from untappd_search_beer');
+export function registerWishlistTools(server) {
+    server.registerTool('untappd_wishlist_add', {
+        title: 'Add a beer to your wishlist',
+        description: 'Add a beer to YOUR Untappd wishlist by its bid. Without confirm: true it returns a dry-run preview and ' +
+            'makes NO network call; with confirm: true it adds. Writes to your account.',
+        annotations: toolAnnotations({ title: 'Add a beer to your wishlist', readOnly: false, idempotent: true, openWorld: true }),
+        inputSchema: {
+            bid: BidSchema,
+            confirm: schemaConfirm,
+        },
+    }, async ({ bid, confirm }) => {
+        if (confirm !== true) {
+            return textResult({
+                dryRun: true,
+                action: 'wishlist_add',
+                bid,
+                note: 'Dry run — re-run with confirm: true to add this beer to your wishlist.',
+            });
+        }
+        const data = await client.write('GET', '/user/wishlist/add', { query: { bid } });
+        return textResult({ added: true, bid, result: data?.result });
+    });
+    server.registerTool('untappd_wishlist_remove', {
+        title: 'Remove a beer from your wishlist',
+        description: 'Remove a beer from YOUR Untappd wishlist by its bid. Without confirm: true it returns a dry-run preview ' +
+            'and makes NO network call; with confirm: true it removes. Writes to your account.',
+        annotations: toolAnnotations({ title: 'Remove a beer from your wishlist', readOnly: false, idempotent: true, openWorld: true }),
+        inputSchema: {
+            bid: BidSchema,
+            confirm: schemaConfirm,
+        },
+    }, async ({ bid, confirm }) => {
+        if (confirm !== true) {
+            return textResult({
+                dryRun: true,
+                action: 'wishlist_remove',
+                bid,
+                note: 'Dry run — re-run with confirm: true to remove this beer from your wishlist.',
+            });
+        }
+        const data = await client.write('GET', '/user/wishlist/delete', { query: { bid } });
+        return textResult({ removed: true, bid, result: data?.result });
+    });
+}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "0.0.0",
+  "version": "1.0.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>",
@@ -46,10 +46,10 @@
     "zod": "^4.4.2"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.2",
     "esbuild": "^0.28.0",
-    "typescript": "^6.0.2",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.2"
   }
 }

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/untappd-mcp",
     "source": "github"
   },
-  "version": "0.0.0",
+  "version": "1.0.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "untappd-mcp",
-      "version": "0.0.0",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
       },