untappd-mcp 1.0.0 → 1.2.0

package/dist/tools/resolve.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations, createHelpfulError } from '@chrischall/mcp-utils';
+/**
+ * Parse an untappd.com URL into its entity type and id. Path shapes (confirmed
+ * from the app + site):
+ *   /b/<slug>/<bid>              → beer
+ *   /w/<slug>/<brewery_id>       → brewery
+ *   /v/<slug>/<venue_id>         → venue
+ *   /user/<username>             → user
+ *   /user/<username>/checkin/<id>→ checkin
+ * Returns null if the URL isn't a recognised Untappd entity URL.
+ */
+export function parseUntappdUrl(input) {
+    let url;
+    try {
+        url = new URL(input.trim());
+    }
+    catch {
+        return null;
+    }
+    if (!/(^|\.)untappd\.com$/i.test(url.hostname))
+        return null;
+    const segs = url.pathname.split('/').filter(Boolean);
+    // /user/<username>/checkin/<id>
+    if (segs[0] === 'user' && segs[2] === 'checkin' && /^\d+$/.test(segs[3] ?? '')) {
+        return { type: 'checkin', id: Number(segs[3]), username: segs[1], tool: 'untappd_checkin_info' };
+    }
+    // /user/<username>
+    if (segs[0] === 'user' && segs[1]) {
+        return { type: 'user', username: segs[1], tool: 'untappd_user_info' };
+    }
+    const short = {
+        b: { type: 'beer', tool: 'untappd_beer_info' },
+        w: { type: 'brewery', tool: 'untappd_brewery_info' },
+        v: { type: 'venue', tool: 'untappd_venue_info' },
+    };
+    // /b|w|v/<slug>/<id>  (id is the last numeric segment)
+    if (segs[0] && short[segs[0]]) {
+        const last = segs[segs.length - 1];
+        if (/^\d+$/.test(last)) {
+            return { ...short[segs[0]], id: Number(last) };
+        }
+    }
+    return null;
+}
+export function registerResolveTools(server, client) {
+    server.registerTool('untappd_resolve', {
+        title: 'Resolve an Untappd URL',
+        description: 'Parse an untappd.com URL (a beer /b/, brewery /w/, venue /v/, user /user/, or check-in link) into its ' +
+            'entity type and id, and name the tool to call next. Pure local parsing — no network. Read-only.',
+        annotations: toolAnnotations({ title: 'Resolve an Untappd URL', readOnly: true, idempotent: true, openWorld: false }),
+        inputSchema: {
+            url: z.string().min(1).describe('An untappd.com URL to resolve'),
+        },
+    }, async ({ url }) => {
+        const resolved = parseUntappdUrl(url);
+        if (!resolved) {
+            throw createHelpfulError(`Not a recognised Untappd entity URL: ${url}`, {
+                hint: 'Expected an untappd.com link like /b/<slug>/<bid>, /w/<slug>/<id>, /v/<slug>/<id>, or /user/<name>.',
+            });
+        }
+        return textResult(resolved);
+    });
+    server.registerTool('untappd_open_url', {
+        title: 'Open an Untappd URL (resolve + fetch)',
+        description: 'Resolve an untappd.com URL AND fetch the entity detail in one call — the convenience combination of ' +
+            'untappd_resolve + the matching info tool. Returns { resolved, detail }. Read-only.',
+        annotations: toolAnnotations({ title: 'Open an Untappd URL', readOnly: true, idempotent: true, openWorld: true }),
+        inputSchema: {
+            url: z.string().min(1).describe('An untappd.com URL to resolve and fetch'),
+        },
+    }, async ({ url }) => {
+        const resolved = parseUntappdUrl(url);
+        if (!resolved) {
+            throw createHelpfulError(`Not a recognised Untappd entity URL: ${url}`, {
+                hint: 'Expected an untappd.com link like /b/<slug>/<bid>, /w/<slug>/<id>, /v/<slug>/<id>, or /user/<name>.',
+            });
+        }
+        const path = resolved.type === 'beer'
+            ? `/beer/info/${resolved.id}`
+            : resolved.type === 'brewery'
+                ? `/brewery/info/${resolved.id}`
+                : resolved.type === 'venue'
+                    ? `/venue/info/${resolved.id}`
+                    : resolved.type === 'checkin'
+                        ? `/checkin/view/${resolved.id}`
+                        : `/user/info/${encodeURIComponent(resolved.username)}`;
+        const detail = await client.get(path);
+        return textResult({ resolved, detail });
+    });
+}

package/dist/tools/user.js

@@ -1,14 +1,14 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations, createHelpfulError } from '@chrischall/mcp-utils';
-import { client } from '../client.js';
+import { compactCheckins, compactWishlist, compactUserBeers } from '../compact.js';
 const UsernameArg = z
     .string()
     .min(1)
     .optional()
     .describe('Untappd username. Omit to use your own configured account (UNTAPPD_USERNAME).');
 /** Resolve the target username: explicit arg, else the configured login name. */
-function resolveUser(username) {
-    const u = username ?? client.loginName;
+function resolveUser(username, loginName) {
+    const u = username ?? loginName;
     if (!u) {
         throw createHelpfulError('No username given and no configured account to fall back to.', {
             hint: 'Pass `username`, or set UNTAPPD_USERNAME so user tools default to your own account.',
@@ -16,7 +16,7 @@ function resolveUser(username) {
     }
     return encodeURIComponent(u);
 }
-export function registerUserTools(server) {
+export function registerUserTools(server, client) {
     server.registerTool('untappd_user_info', {
         title: 'Get Untappd user profile',
         description: "Get an Untappd user's profile: bio, location, total check-ins, distinct beers, badges, and stats. " +
@@ -27,7 +27,7 @@ export function registerUserTools(server) {
             compact: z.boolean().optional().describe('Return a slimmer record without embedded lists (default false)'),
         },
     }, async ({ username, compact }) => {
-        const data = await client.get(`/user/info/${resolveUser(username)}`, { compact: compact ? 'true' : undefined });
+        const data = await client.get(`/user/info/${resolveUser(username, client.loginName)}`, { compact: compact ? 'true' : undefined });
         return textResult(data);
     });
     server.registerTool('untappd_user_checkins', {
@@ -39,10 +39,14 @@ export function registerUserTools(server) {
             username: UsernameArg,
             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)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ username, limit, max_id }) => {
-        const data = await client.get(`/user/checkins/${resolveUser(username)}`, { limit, max_id });
-        return textResult(data);
+    }, async ({ username, limit, max_id, compact }) => {
+        const data = await client.get(`/user/checkins/${resolveUser(username, client.loginName)}`, { limit, max_id });
+        return textResult(compact ? compactCheckins(data) : data);
     });
     server.registerTool('untappd_user_wishlist', {
         title: 'Get Untappd user wishlist',
@@ -56,10 +60,14 @@ export function registerUserTools(server) {
                 .enum(['date', 'name', 'brewery', 'style', 'rating', 'abv'])
                 .optional()
                 .describe('Sort order (default date added, newest first)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each beer to a slim summary (bid, name, brewery, style, abv, added_at) to save context (default false)'),
         },
-    }, async ({ username, limit, offset, sort }) => {
-        const data = await client.get(`/user/wishlist/${resolveUser(username)}`, { limit, offset, sort });
-        return textResult(data);
+    }, async ({ username, limit, offset, sort, compact }) => {
+        const data = await client.get(`/user/wishlist/${resolveUser(username, client.loginName)}`, { limit, offset, sort });
+        return textResult(compact ? compactWishlist(data) : data);
     });
     server.registerTool('untappd_user_beers', {
         title: 'Get Untappd distinct beers',
@@ -74,10 +82,14 @@ export function registerUserTools(server) {
                 .enum(['date', 'checkin', 'highest_rated', 'lowest_rated', 'name', 'this_month', 'highest_abv'])
                 .optional()
                 .describe('Sort order (default date, most recent first)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each beer to a slim summary (bid, name, brewery, style, abv, ibu, your_count, your_rating, global_rating, last_had) to save context (default false)'),
         },
-    }, async ({ username, limit, offset, sort }) => {
-        const data = await client.get(`/user/beers/${resolveUser(username)}`, { limit, offset, sort });
-        return textResult(data);
+    }, async ({ username, limit, offset, sort, compact }) => {
+        const data = await client.get(`/user/beers/${resolveUser(username, client.loginName)}`, { limit, offset, sort });
+        return textResult(compact ? compactUserBeers(data) : data);
     });
     server.registerTool('untappd_user_badges', {
         title: 'Get Untappd user badges',
@@ -89,7 +101,7 @@ export function registerUserTools(server) {
             offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
         },
     }, async ({ username, limit, offset }) => {
-        const data = await client.get(`/user/badges/${resolveUser(username)}`, { limit, offset });
+        const data = await client.get(`/user/badges/${resolveUser(username, client.loginName)}`, { limit, offset });
         return textResult(data);
     });
     server.registerTool('untappd_user_friends', {
@@ -102,7 +114,38 @@ export function registerUserTools(server) {
             offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
         },
     }, async ({ username, limit, offset }) => {
-        const data = await client.get(`/user/friends/${resolveUser(username)}`, { limit, offset });
+        const data = await client.get(`/user/friends/${resolveUser(username, client.loginName)}`, { limit, offset });
+        return textResult(data);
+    });
+    server.registerTool('untappd_user_venues', {
+        title: 'Get venues a user has checked in at',
+        description: "Get the venues a user has checked in at, most recent first, with per-venue check-in counts. Supports " +
+            'sorting and paging. 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 }),
+        inputSchema: {
+            username: UsernameArg,
+            limit: z.number().int().min(1).max(50).optional().describe('Max venues (1–50, default 25)'),
+            offset: z.number().int().min(0).optional().describe('Result offset for paging (default 0)'),
+            sort: z
+                .enum(['date', 'name', 'checkin', 'highest_rated'])
+                .optional()
+                .describe('Sort order (default most recent)'),
+        },
+    }, async ({ username, limit, offset, sort }) => {
+        const data = await client.get(`/user/venues/${resolveUser(username, client.loginName)}`, { limit, offset, sort });
+        return textResult(data);
+    });
+    server.registerTool('untappd_pending_friends', {
+        title: 'Get your pending friend requests',
+        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 }),
+        inputSchema: {
+            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)'),
+        },
+    }, async ({ limit, offset }) => {
+        const data = await client.get('/user/pending', { limit, offset });
         return textResult(data);
     });
 }

package/dist/tools/utilities.js

@@ -1,6 +1,5 @@
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
-import { client } from '../client.js';
-export function registerUtilityTools(server) {
+export function registerUtilityTools(server, client) {
     server.registerTool('untappd_healthcheck', {
         title: 'Untappd healthcheck',
         description: 'Verify Untappd connectivity and that credentials are configured and can log in. Performs a lightweight ' +

package/dist/tools/venue.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
-import { client } from '../client.js';
-export function registerVenueTools(server) {
+import { compactCheckins } from '../compact.js';
+export function registerVenueTools(server, client) {
     server.registerTool('untappd_search_venue', {
         title: 'Search Untappd venues',
         description: 'Search Untappd for venues (bars, breweries, restaurants) by name. Returns matches with their venue id, ' +
@@ -28,6 +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_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) ' +
+            '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 }),
+        inputSchema: {
+            foursquare_id: z.string().min(1).describe('Foursquare venue id'),
+        },
+    }, async ({ foursquare_id }) => {
+        const data = await client.get(`/venue/foursquare_lookup/${encodeURIComponent(foursquare_id)}`);
+        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. ' +
@@ -37,9 +49,13 @@ export function registerVenueTools(server) {
             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)'),
+            compact: z
+                .boolean()
+                .optional()
+                .describe('Project each check-in to a slim summary to save context (default false)'),
         },
-    }, async ({ venue_id, limit, max_id }) => {
+    }, async ({ venue_id, limit, max_id, compact }) => {
         const data = await client.get(`/venue/checkins/${venue_id}`, { limit, max_id });
-        return textResult(data);
+        return textResult(compact ? compactCheckins(data) : data);
     });
 }

package/dist/tools/wishlist.js

@@ -1,8 +1,7 @@
 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) {
+export function registerWishlistTools(server, client) {
     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 ' +

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "untappd-mcp",
-  "version": "1.0.0",
+  "version": "1.2.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>",
@@ -37,19 +37,27 @@
     "dev": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "worker:dev": "wrangler dev",
+    "worker:deploy": "wrangler deploy",
+    "worker:test": "vitest run --config vitest.workers.config.ts"
   },
   "dependencies": {
     "@chrischall/mcp-utils": "^0.12.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "ai": "^7.0.19",
     "dotenv": "^17.4.0",
     "zod": "^4.4.2"
   },
   "devDependencies": {
+    "@chrischall/mcp-connector": "file:./packages/mcp-connector",
+    "@cloudflare/vitest-pool-workers": "^0.18.4",
+    "@cloudflare/workers-types": "^5.20260708.1",
     "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.2",
     "esbuild": "^0.28.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.2",
+    "wrangler": "^4.110.0"
   }
 }

package/server.json

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