Untappd MCP for AI. Track your beer history and friend activity.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
How this MCP server connects to your AI agent
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.
What AI agents can do with Untappd Automation
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.
Your agent records a check-in for a specific beer, adding it to your public feed.
The system retrieves the recent activity log (check-ins, comments) from a specified friend's account.
It pulls deep details about any beer—style, rating, ABV, IBU—using its unique ID.
The agent executes searches for both beers (search_beer) and breweries (search_brewery).
You can send friend requests using request_friend, or accept/reject incoming requests.
Ask an AI about this
Waiting for input…
What AI agents can do with Untappd MCP Server: 30 Tools for Beer & Venue Data
These thirty tools give your AI client direct access to the Untappd API. Use them to search beers, manage social friends, and pull detailed activity feeds from any user or venue.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Untappd on VinkiusAccept 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...
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.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Untappd integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Untappd, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Untappd. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 30 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Remember that tracking your beer history shouldn't feel like homework., Solved with Vinkius AI Gateway
Right now, if you want to know what happened at a brewery you visited last month, you have to open the Untappd app. You click on the venue, scroll through potentially dozens of check-ins, and try to piece together who was there and what they were drinking. It's clicking through tabs and sifting through noise.
With this MCP server, you just ask your agent: "Show me the beer activity for The Brewery." You get a clean feed right in your chat window—the names, the beers, the ratings—without ever touching the actual Untappd application. It’s pure data delivery.
Using the Untappd MCP Server: Your Agent Handles All the Links.
Before this, if you found a cool brewery name, you had to manually search for it. Then, you'd have to check its activity feed separately from checking out its profile info or its related beer details. It was three separate steps just to get context.
Now, you ask your agent one thing: "Tell me about Stone Brewing." It uses `get_brewery_info` AND `search_brewery` and `get_beer_activity` all at once, stitching the whole story together for you. That's how it should work.
What your AI can actually do with this
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_friendsto pull the full list of contacts. If you want to connect with someone new, just fire off a request usingrequest_friend. When requests come in, the agent shows all pending friend requests viaget_pending_friends, letting you accept them withaccept_friendor decline them withreject_friend. You can also useremove_friendto 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 withget_user_activity. You can get a consolidated view of news, comments, and toasts on your profile throughget_notifications. If you want to see what’s happening at a physical spot, the agent retrieves the venue activity feed usingget_venue_activityor checks out a specific brewery's history withget_brewery_activity. You can even track down activity for just one beer ID usingget_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 usingtoggle_toast. If you want to leave a comment on a friend’s recent find, useadd_comment; if you change your mind,remove_commentdeletes that comment. You can also get extended details for any check-in—like where it happened or who commented—by callingget_checkin_details. To track future plans, the agent displays a list of beers you plan to drink usingget_user_wishlist, and you can add new targets withadd_to_wishlistor remove old ones withremove_from_wishlist; it'll also let you clear your whole list withremove_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 withsearch_beer. For deeper context on a brew, useget_brewery_infoto pull everything from its history to its beer lineup. If you're looking for breweries near you, you can execute searches withsearch_brewery; if you have a Foursquare ID and need the Untappd Venue ID, runfoursquare_lookup. For detailed info about any physical location, bar or brewery, useget_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_beerslists all unique beers they recorded. The basic profile details for any user—like their name or location—show up when the agent runsget_user_info. You can also find out which friends you've connected with usingget_user_friends.
019e5d64-561d-703c-937d-7e1ba0572d15 
Here's how it actually works
The bottom line is: Your AI client becomes a universal wrapper around Untappd’s entire database and social feed.
First, subscribe to the Untappd MCP Server and provide your access token. This hooks up your AI client.
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.
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.
Who is this actually for?
This is for the dedicated craft beer enthusiast, the local bar owner running inventory reports, or the data hobbyist who tracks consumption patterns. If you're tired of having to manually open the app just to see what your friends drank last night, this saves you time. It lets you treat social drinking history like a queryable database.
Uses the agent to check beer ratings and metadata while standing at a bar or brewery counter without opening any apps.
Keeps up with friends' activity feeds by querying tools like get_friend_activity using simple conversation prompts.
Gathers massive amounts of brewery and beer metadata for personal research, trend spotting, or writing articles on regional styles.
What Changes When You Connect
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.
See it in action
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.
The honest tradeoffs
Trying to get all beer data manually
Going into the app, clicking on one friend's profile, then navigating through their feed, finding a brewery ID, and finally looking up that brewerey’s beers. It takes forever.
Just ask your agent to get_friend_activity and specify which user you want info for. The server handles the entire multi-step data retrieval process instantly.
Ignoring friend requests
Seeing a notification that someone wants to connect, but then having to open the app, find the request list, and manually hit 'Accept'. Annoying.
Tell your agent to check get_pending_friends. If you're ready, just ask it to accept_friend by name. Done in two seconds.
Asking for general beer info
Saying 'What's a good IPA?' and getting nothing useful because the API needs specific identifiers.
Be precise. Instead of asking generally, ask your agent to use search_beer with keywords like 'IPA' AND limit it by location using get_venue_info.
When It Fits, When It Doesn't
Use this server if you treat beer history and social check-ins as structured data. If the goal is simply 'I want to know what my friends are doing,' or 'What's the rating on that brewery?'—this is your tool. The key benefit here isn't just access, it’s the ability to query complex relationships (like: 'Show me beers friend X drank at venue Y').
Don't use this if you need real-time physical data like a photo or an immediate chat message that hasn't been formalized as a check-in. If your core task is writing a blog post about beer, use get_beer_info to gather the facts, then write it elsewhere. You should not use this if you need to interact with payment systems or ticketing, because we only handle Untappd data. This server excels at read/write social and metadata actions; everything else requires a different kind of API.
Questions you might have
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.
We've already built the connector for Untappd. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 30 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.