Untappd
Connects Claude to the Untappd API for searching breweries, beers, and venues, plus pulling recent check-in feeds to see what's on tap. You get venue and brewery lookups, beer search with sorting, and user activity feeds. The most useful pattern here is searching for a venue, grabbing its ID, then fetching recent check-ins as a proxy for live tap lists, since Untappd's actual menu data sits behind their business tier. Rate limited to 100 calls per hour. Requires a free API key from Untappd. Good for building beer recommendation flows or answering "what's pouring at X right now" without leaving your chat window.
- tools
- 26
- auth
- Secret needed
- transport
- STDIO
- env vars
- 6
- last updated
- Oct 27, 2026
Tools
26 toolsPublic tool metadata for what this MCP can expose to an agent.
authenticate_untappdInteractively authenticate with Untappd via OAuth: opens your browser to Untappd's approve page, captures the redirect on a temporary localhost listener, and saves the access token — the 🔑 tools work immediately, no restart.
Interactively authenticate with Untappd via OAuth: opens your browser to Untappd's approve page, captures the redirect on a temporary localhost listener, and saves the access token — the 🔑 tools work immediately, no restart.
No parameter schema in public metadata yet.
get_auth_statusReport authentication status: token presence, source (env var or token file), file path, and whether the 🔑 tools are unlocked. Free by default; `validate: true` verifies the token with one API call.
Report authentication status: token presence, source (env var or token file), file path, and whether the 🔑 tools are unlocked. Free by default; `validate: true` verifies the token with one API call.
No parameter schema in public metadata yet.
venue_searchSearch for venues (breweries, bars, restaurants) by name with optional location awareness.
Search for venues (breweries, bars, restaurants) by name with optional location awareness.
No parameter schema in public metadata yet.
search_brewerySearch for breweries by name.
Search for breweries by name.
No parameter schema in public metadata yet.
search_beerSearch for beers by name.
Search for beers by name.
No parameter schema in public metadata yet.
get_venue_infoRetrieve detailed information and recent check-ins for a venue.
Retrieve detailed information and recent check-ins for a venue.
No parameter schema in public metadata yet.
get_venue_checkinsRetrieve the recent check-in feed for a venue. This is the primary tool for determining what's currently on tap — recent check-ins act as a live signal for available beers.
Retrieve the recent check-in feed for a venue. This is the primary tool for determining what's currently on tap — recent check-ins act as a live signal for available beers.
No parameter schema in public metadata yet.
get_venue_foursquare_lookupResolve a Foursquare venue ID to its Untappd venue — the bridge between Foursquare/location data and Untappd venue tools.
Resolve a Foursquare venue ID to its Untappd venue — the bridge between Foursquare/location data and Untappd venue tools.
No parameter schema in public metadata yet.
get_beer_infoRetrieve detailed information for a specific beer.
Retrieve detailed information for a specific beer.
No parameter schema in public metadata yet.
get_beer_checkinsRetrieve the recent public check-in feed for a specific beer — what people are saying about it right now, and where they're drinking it.
Retrieve the recent public check-in feed for a specific beer — what people are saying about it right now, and where they're drinking it.
No parameter schema in public metadata yet.
get_trending_beersRetrieve globally trending beers (macro and micro brew lists, by recent check-in velocity). No parameters.
Retrieve globally trending beers (macro and micro brew lists, by recent check-in velocity). No parameters.
No parameter schema in public metadata yet.
get_brewery_infoRetrieve detailed information, beer list, and recent check-ins for a brewery.
Retrieve detailed information, beer list, and recent check-ins for a brewery.
No parameter schema in public metadata yet.
get_brewery_checkinsRetrieve the recent public check-in feed for a brewery — all its beers being checked in globally.
Retrieve the recent public check-in feed for a brewery — all its beers being checked in globally.
No parameter schema in public metadata yet.
get_user_infoRetrieve profile and stats for an Untappd user.
Retrieve profile and stats for an Untappd user.
No parameter schema in public metadata yet.
get_user_activityRetrieve the recent check-in activity feed for a user.
Retrieve the recent check-in activity feed for a user.
No parameter schema in public metadata yet.
get_user_distinct_beersRetrieve the unique beers a user has checked in, with flexible sort ordering. `sort=checkin` with `limit=1` is the single-call pattern for "most-checked-in beer".
Retrieve the unique beers a user has checked in, with flexible sort ordering. `sort=checkin` with `limit=1` is the single-call pattern for "most-checked-in beer".
No parameter schema in public metadata yet.
get_user_wishlistRetrieve beers on a user's wish list.
Retrieve beers on a user's wish list.
No parameter schema in public metadata yet.
get_user_badgesRetrieve a user's earned badges (pages of 50, most recent first).
Retrieve a user's earned badges (pages of 50, most recent first).
No parameter schema in public metadata yet.
get_user_friendsRetrieve a user's friend list (public accounts only).
Retrieve a user's friend list (public accounts only).
No parameter schema in public metadata yet.
get_global_feedRetrieve 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.
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.
No parameter schema in public metadata yet.
get_local_feedRetrieve the public check-in feed near a geographic point.
Retrieve the public check-in feed near a geographic point.
No parameter schema in public metadata yet.
get_friend_feedRetrieve the friend check-in feed for the authenticated user.
Retrieve the friend check-in feed for the authenticated user.
No parameter schema in public metadata yet.
get_checkin_infoRetrieve extended details for a specific check-in, including badges earned, toasts, and comments.
Retrieve extended details for a specific check-in, including badges earned, toasts, and comments.
No parameter schema in public metadata yet.
get_user_stats_at_venueGet 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.
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.
No parameter schema in public metadata yet.
search_venue_then_get_user_statsSearch for a venue by name, then get the user's check-in stats at the top match.
Search for a venue by name, then get the user's check-in stats at the top match.
No parameter schema in public metadata yet.
get_user_beer_statsAggregate a user's distinct beer history into style, brewery, and rating breakdowns — top styles, top breweries, average personal vs global ratings, highest-rated, and most-checked-in.
Aggregate a user's distinct beer history into style, brewery, and rating breakdowns — top styles, top breweries, average personal vs global ratings, highest-rated, and most-checked-in.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
UNTAPPD_CLIENT_ID*secretUntappd API Client ID
UNTAPPD_CLIENT_SECRET*secretUntappd API Client Secret
UNTAPPD_ACCESS_TOKENsecretUntappd OAuth access token — unlocks the friend feed tool, user-scoped rate limits, and richer /user data. Optional: can instead be obtained interactively via the authenticate_untappd tool or `npx untappd-mcp-server auth` (stored in ~/.untappd-mcp-server/token.json)
UNTAPPD_USERNAMEDefault username for authenticated user tools
UNTAPPD_REDIRECT_URLOAuth redirect URL for interactive authentication — must exactly match the Callback URL registered in your Untappd app settings; default http://localhost:8737/callback
UNTAPPD_TOKEN_PATHOverride path for the saved token file; default ~/.untappd-mcp-server/token.json
Readme
untappd-mcp-server
A Model Context Protocol (MCP) server that exposes the Untappd API as tools for AI agents — 27 tools covering the full Untappd v4 read API, plus built-in interactive OAuth authentication. Search venues, breweries, and beers; check what's on tap via check-in feeds; explore user badges, friends, wish lists, and drinking history; and aggregate stats — all from any MCP-compatible client.
Prerequisites
- Node.js 20+
- Untappd API credentials (
client_idandclient_secret) from untappd.com/api - Optional: an Untappd OAuth access token to unlock authenticated tools — obtainable in-chat via the
authenticate_untappdtool ornpx untappd-mcp-server auth(see Interactive Authentication)
Quick Start
Via npx (zero install)
Details
- Repository
- github.com/darrenjrobinson/untappd-mcp-server
- Package
untappd-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active