# Untappd MCP > Untappd MCP Server lets your AI client read and write to the Untappd social graph. You can track beer check-ins, pull detailed metadata for any brewery or beer ID, manage friend requests, and monitor activity feeds for specific venues or users. It’s built for anyone who uses craft beer history as a data point—from casual drinkers wanting to keep up with friends' latest finds to data analysts building personal trend models. ## Overview - **Category:** gaming-entertainment - **Price:** Free - **Tags:** beer-tracking, brewery-database, social-drinking, check-ins, craft-beer ## Description The Untappd MCP Server lets your AI client read and write directly to the Untappd social graph. You can track beer check-ins, pull deep metadata for any brewery or beer ID, manage friend requests, and monitor activity feeds for specific venues or users. It’s built for anyone who uses craft beer history as a data point—from casual drinkers keeping tabs on friends' latest finds to people building personal trend models. **Managing Friends and Social Connections** * To keep up with your crew, you can use `get_user_friends` to pull the full list of contacts. If you want to connect with someone new, just fire off a request using `request_friend`. When requests come in, the agent shows all pending friend requests via `get_pending_friends`, letting you accept them with `accept_friend` or decline them with `reject_friend`. You can also use `remove_friend` to cut ties and delete a connection from your list. * You'll never miss what everyone’s doing: the agent pulls a friend check-in feed using `get_friend_activity`, or you can monitor activity for any specific user with `get_user_activity`. You can get a consolidated view of news, comments, and toasts on your profile through `get_notifications`. If you want to see what’s happening at a physical spot, the agent retrieves the venue activity feed using `get_venue_activity` or checks out a specific brewery's history with `get_brewery_activity`. You can even track down activity for just one beer ID using `get_beer_activity`. **Tracking Your Beer Journey and Interactions** * When you check in, the agent records a new check-in for the currently logged-in beer via `add_checkin`, adding it straight to your public feed. You can make sure your post gets noticed by marking the check-in as 'toasted' or Untoast using `toggle_toast`. If you want to leave a comment on a friend’s recent find, use `add_comment`; if you change your mind, `remove_comment` deletes that comment. You can also get extended details for any check-in—like where it happened or who commented—by calling `get_checkin_details`. To track future plans, the agent displays a list of beers you plan to drink using `get_user_wishlist`, and you can add new targets with `add_to_wishlist` or remove old ones with `remove_from_wishlist`; it'll also let you clear your whole list with `remove_from_wishlist`. **Researching Beers and Breweries** * Need stats? You don’t gotta open the app. The agent pulls deep details about any beer—including its style, ratings, ABV, or IBU—using `get_beer_info`. To find specific brews, you can search the database using keywords, IDs, or brewery names with `search_beer`. For deeper context on a brew, use `get_brewery_info` to pull everything from its history to its beer lineup. If you're looking for breweries near you, you can execute searches with `search_brewery`; if you have a Foursquare ID and need the Untappd Venue ID, run `foursquare_lookup`. For detailed info about any physical location, bar or brewery, use `get_venue_info`. **Monitoring Trends and Users** * To see what everyone's drinking right now, the agent pulls global data on macro and micro trending beers using `get_trending_beers`. If you just want to know what a specific person drank in their history, `get_user_distinct_beers` lists all unique beers they recorded. The basic profile details for any user—like their name or location—show up when the agent runs `get_user_info`. You can also find out which friends you've connected with using `get_user_friends`. ## Tools ### accept_friend Accepts a pending friend request from another user. ### add_checkin Records a new check-in for the currently logged-in beer. ### add_comment Posts text as a comment on an existing friend's check-in. ### add_to_wishlist Adds the specified beer to your personal list of beers you plan to try. ### get_beer_activity Retrieves the activity feed specific to one beer by its ID. ### get_beer_info Pulls detailed information about a specific beer, including style and ratings. ### get_brewery_activity Retrieves the activity feed for a single brewery location. ### get_brewery_info Pulls detailed information about a specific brewery, including its history and beers. ### get_checkin_details Gets extended details for any check-in, like where it happened or who commented on it. ### foursquare_lookup Translates a Foursquare ID into the correct Untappd Venue ID needed for lookups. ### get_friend_activity Pulls the friend check-in feed of the authenticated user. ### get_notifications Retrieves a consolidated feed of toasts, comments, and news for your profile. ### get_pending_friends Lists all friend requests that are currently awaiting your decision. ### reject_friend Declines an incoming friend request from another user. ### remove_comment Removes a comment you previously posted on a check-in. ### remove_friend Deletes a friend connection from your list of contacts. ### remove_from_wishlist Removes a beer you had previously added to your personal wishlist. ### request_friend Sends a new friend request to another user. ### search_beer Searches the database for beers using keywords, IDs, or brewery names. ### search_brewery Searches the database for breweries by name or location. ### toggle_toast Marks a check-in as 'toasted' (or Untoast) to add extra flair. ### get_trending_beers Returns global data showing the macro and micro trending beers right now. ### get_user_activity Obtains a check-in feed for a specific user, or your own if no name is given. ### get_user_badges Retrieves the list of achievement badges earned by a specified user. ### get_user_distinct_beers Lists all unique beers that a specific user has recorded drinking in their history. ### get_user_friends Retrieves the full list of friends associated with your account. ### get_user_info Pulls the basic profile details for any user, including name and location. ### get_user_wishlist Displays a list of beers that the specified user intends to drink in the future. ### get_venue_activity Retrieves the activity feed for a specific physical location or venue. ### get_venue_info Gets detailed information about a specific brewery or bar location. ## Prompt Examples **Prompt:** ``` Show me the latest beer check-ins from my friends. ``` **Response:** ``` I've retrieved your friend feed. Your friend 'JohnD' just checked into a 'Punk IPA' by BrewDog at 'The Craft Bar' with a 4.25 rating. 'SarahB' is having a 'Guinness Draught' at home. ``` **Prompt:** ``` What are the details for beer ID 4481? ``` **Response:** ``` Beer ID 4481 is 'Anchor Steam Beer' by Anchor Brewing Company. It's a California Common style with 4.9% ABV and 33 IBU. It has a global rating of 3.51 based on over 300,000 check-ins. ``` **Prompt:** ``` Search for a brewery named 'Stone Brewing'. ``` **Response:** ``` I found 'Stone Brewing' (ID: 1204) located in Escondido, CA. They have over 500 beers listed and a brewery rating of 4.02. Would you like to see their most popular beers? ``` ## Capabilities ### Check in to Beer Your agent records a check-in for a specific beer, adding it to your public feed. ### View Friend Activity Feeds The system retrieves the recent activity log (check-ins, comments) from a specified friend's account. ### Fetch Beer Metadata It pulls deep details about any beer—style, rating, ABV, IBU—using its unique ID. ### Search and Discover Locations/Products The agent executes searches for both beers (`search_beer`) and breweries (`search_brewery`). ### Manage Social Connections You can send friend requests using `request_friend`, or accept/reject incoming requests. ## Use Cases ### Figuring out the vibe at a new bar You just walked into 'The Tap Room' and want to know if it’s known for IPAs. You ask your agent, "What beers are popular here?" The agent uses `get_venue_activity` (after finding the venue ID with `foursquare_lookup`), pulling real-time check-ins so you can gauge the crowd's taste before ordering. ### Debating beer merits with a friend Your buddy mentions an obscure German lager. You ask your agent, "Give me all the stats on that." The agent calls `get_beer_info` using the ID, instantly returning ABV, IBU, and ratings. No more guessing games about whether it was a good drink. ### Keeping track of future goals You found a list of amazing breweries from a trip last year. You tell your agent to add them to your plan. It uses `add_to_wishlist` for each brewery's best beer, so you can cross-reference it later with `get_user_wishlist` when planning your next outing. ### Catching up on friends’ drinking habits It’s been a week since you saw 'Mike'. You ask, "What'd Mike get into?" The agent uses `get_user_activity` (passing Mike's username) and provides the full feed of his recent check-ins, letting you know what he was drinking. ## Benefits - Keep up with friends' latest finds using `get_friend_activity`. You simply ask for the feed, and the server pulls all recent check-ins, saving you from having to open the app just to see who was drinking what. It’s immediate social context. - Deep dive into beer facts instantly. Need ABV or IBU? Use `get_beer_info` with a simple ID lookup. You get detailed metadata—stuff that takes minutes of clicking through menus on the official site. - Build your personal record effortlessly. When you find a brewery, use `search_brewery` and then `get_brewery_info` to pull all the history in one go. It organizes data better than any manual spreadsheet. - Manage social connections without leaving chat. Instead of navigating friend requests, just tell your agent to check `get_pending_friends`. You can accept (`accept_friend`) or reject them instantly via command. - Track your consumption journey meticulously. Use `add_to_wishlist` for future goals and `get_user_distinct_beers` to see exactly what you’ve tasted, all without lifting a finger. - Discover local spots quickly. If you know the Foursquare ID of a place, use `foursquare_lookup` first. This translates it into an Untappd Venue ID so you can pull relevant activity feeds with `get_venue_activity`. ## How It Works The bottom line is: Your AI client becomes a universal wrapper around Untappd’s entire database and social feed. 1. First, subscribe to the Untappd MCP Server and provide your access token. This hooks up your AI client. 2. Next, you prompt your agent with a task (e.g., 'What are the best local beers?'). The agent figures out which tool to use, like `search_beer`. 3. The server executes the tool call, gets the raw data from Untappd's API, and sends only the structured result back to your client for display. ## Frequently Asked Questions **How do I use add_checkin to track a beer?** You simply ask your agent to check in to the specific beer by ID or name. The server executes `add_checkin`, posting it to your feed instantly, so you don't have to open the app. **Can I get all my friend’s activity using get_user_activity?** Yes. If you omit a username from your prompt, `get_user_activity` defaults to pulling your own feed. You can also pass another user's name to see their check-in history. **What is the difference between get_beer_info and search_beer?** `search_beer` finds beers based on keywords or IDs, giving you a list of matches. `get_beer_info`, however, takes one specific ID and returns all the detailed facts—ABV, IBU, etc.—for that single item. **How do I find out what friends are doing?** Ask your agent to use `get_friend_activity`. This tool pulls a consolidated feed of recent check-ins across all your connected contacts. It's the fastest way to see who's drinking what. **Do I need Foursquare IDs for get_venue_info?** Not necessarily, but if you have a Foursquare ID, use `foursquare_lookup` first. This ensures the server translates that external ID into the correct internal Untappd Venue ID before running `get_venue_info`. **How do I use `request_friend` to start tracking a friend’s activity?** Using `request_friend` sends an explicit request that must be accepted by the user. This tool establishes the social connection; you won't gain access to their feed until they accept your invitation. **What extra information does `get_checkin_details` pull for a check-in?** `get_checkin_details` provides more than just the beer and rating. It pulls extended context, including the exact location of the check-in, any comments left on it, and whether or not a toast was added. **Do I need special permissions or an access token to use tools like `add_checkin`?** Yes, every action requires you to provide a valid Untappd Access Token. This token authenticates your identity and grants your agent the necessary permission to post check-ins on your behalf. **How can I see what my friends have been drinking recently?** You can use the `get_friend_activity` tool. It fetches the latest check-in feed from your Untappd friends, including beer names, ratings, and locations. **Can I get detailed information about a specific beer if I have its ID?** Yes! Use the `get_beer_info` tool with the Beer ID (bid). It will return comprehensive metadata, including ABV, IBU, brewery details, and global ratings. **Is it possible to add a new beer check-in through the AI agent?** Absolutely. The `add_checkin` tool allows you to post a new check-in by providing the Beer ID, and optionally a rating, comments, and location.