Interactively authenticate the user with Untappd via OAuth to unlock get_friend_feed, user-scoped rate limits, and richer /user data. Opens the user's browser to Untappd's login/approve page and blocks until they approve (up to timeout_seconds). PREREQUISITE: the user's Untappd API app (untappd.com/api) must have its Callback URL set to exactly http://localhost:8737/callback (or the UNTAPPD_REDIRECT_URL value). Requires UNTAPPD_CLIENT_ID + UNTAPPD_CLIENT_SECRET. The token is saved to disk and used immediately — no server restart needed.

Report Untappd authentication status: whether an access token is configured, its source (UNTAPPD_ACCESS_TOKEN env var or the saved token file), the token file path, and whether the authenticated tools are unlocked. Free (no API call) by default; set validate:true to verify the token with one authenticated API call (costs 1 rate-limit call).

Search for venues (breweries, bars, restaurants) by name, with optional location awareness

Search for breweries by name

Search for beers by name

Retrieve detailed information and recent check-ins for a known venue

Retrieve the recent check-in feed for a specific venue. Primary tool for 'what's on tap right now' use case.

Resolve a Foursquare venue ID to its Untappd venue (bridge between Foursquare data and Untappd venue tools)

Retrieve detailed information for a specific beer

Retrieve the recent public check-in feed for a specific beer

Retrieve globally trending beers on Untappd (macro and micro brew lists, by recent check-in velocity)

Retrieve detailed information and recent check-ins for a specific brewery

Retrieve the recent public check-in feed for a brewery (all its beers, globally)

Retrieve profile and stats for a specific Untappd user by username

Retrieve the recent check-in activity feed for a specific Untappd user

Retrieve the unique beers a user has checked in, with flexible sort ordering

Retrieve beers on a user's wish list

Retrieve a user's earned badges (returned in pages of 50, most recent first)

Retrieve a user's friend list (public accounts only)

Retrieve the global public check-in feed (The Pub). High rate-limit cost for the data returned — prefer min_id polling to fetch only new check-ins. Note: standard API keys may not be authorized for this endpoint (Untappd returns 'not authorized to call this method from this key')

Retrieve the public check-in feed near a geographic point (The Pub — Local)

Retrieve the friend check-in feed for the authenticated user (requires UNTAPPD_ACCESS_TOKEN)

Retrieve extended details for a specific check-in, including badges earned, toasts, and comments

Get a user's check-in stats at a specific venue — visit count, last visit, average rating, top beers — by scanning their recent check-in feed (1 API call per 25 check-ins scanned; the stats cover the scanned window, not all time)

Search for a venue by name, then get the user's check-in stats at the top match (1 search call + a scan of the user's recent check-in feed at 25/page)

Aggregate a user's distinct beer history into style, brewery, and rating breakdowns (paginates the API — costs 1 call per 50 beers scanned)

Retrieve all badges for a user (paginating to completion) with a structured summary (costs 1 API call per 50 badges)