# Untappd MCP for AI Agents AI Agent Connect

> Untappd MCP. Track beers, breweries, and venues. Access check-in feeds, beer metadata, and manage your social drinking profile directly from your AI agent. It's the fastest way to keep your craft beer history organized without the friction of manual app entry. Whether you're at a brewery or researching new brews, you can manage your entire drinking profile through natural conversation with your agent.

## Overview
- **Category:** gaming-entertainment
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mMwICnaBL0CZfHCxVdQfxPqFfjhO9Iup8uLDN0TC/ai-agent-connect
- **Tags:** beer-tracking, brewery-database, social-drinking, check-ins, craft-beer

## Description

The Untappd MCP lets you explore the craft beer world through natural conversation with your AI agent. You can pull up details on millions of beers, check what your friends are drinking in real time, and log your own tasting notes without ever opening the mobile app. Instead of digging through menus or scrolling through feeds, you can just ask your agent to find a specific brewery or see what's trending globally. It handles the heavy lifting of fetching metadata, ratings, and social interactions like toasts and comments. You'll find it's a huge time-saver when you're out at a bar or just trying to organize your wishlist. Vinkius makes it easy to get this connected so you can keep your drinking history organized and your social feed updated without the friction of manual data entry.

## Tools

### get_brewery_activity
Get the activity feed for a specific brewery. Use this to see what's happening at a local spot.

### get_brewery_info
Fetch detailed information about any brewery. This gives you stats, ratings, and descriptions.

### get_checkin_details
Pull extended details for a specific checkin. You can see location data, comments, and toasts.

### foursquare_lookup
Convert a Foursquare v2 ID into an Untappd Venue ID. This helps map locations accurately.

### get_friend_activity
Retrieve the check-in feed from your friends. Use this to see what your inner circle is drinking.

### get_notifications
See your feed of toasts, comments, and news. It keeps you updated on social interactions.

### reject_friend
Decline a friend request from another user. Manage your social circle with a simple command.

### remove_comment
Delete a comment you left on a checkin. Use this to clean up your social history.

### remove_friend
Remove a friend from your Untappd account. This keeps your feed focused on the people you want to see.

### search_beer
Search the entire database for specific beers. This is the fastest way to find a new pour.

### toggle_toast
Toast or untoast a checkin. Show some love for a friend's latest find.

### get_trending_beers
See what's trending globally for both macro and micro beers. Stay on top of the latest hits.

### get_user_activity
Get the check-in feed for a specific user. Use this to see what a specific person is drinking.

### get_user_badges
See the list of badges earned by a user. Check out achievements and milestones.

### get_user_distinct_beers
List every unique beer a specific user has had. This is great for seeing a user's variety.

### get_user_friends
List all the friends of a specific user. Quickly see who someone is connected with.

### get_user_info
Pull the profile information for any user. Get a high-level overview of a user's account.

### get_user_wishlist
See the beers on a specific user's wishlist. Find out what they're looking to try next.

### get_venue_info
Get detailed information about a specific venue. This includes location and brewery details.

### remove_from_wishlist
Take a beer off your personal wishlist. This helps keep your to-drink list accurate.

### request_friend
Send a friend request to another user. Grow your social network through your agent.

### search_brewery
Search for breweries by name or location. Use this to find new spots to visit.

### get_venue_activity
Get the activity feed for a specific venue. See what's popping at a particular bar.

### accept_friend
Accept an incoming friend request. Build your social connections easily.

### add_checkin
Log a new beer checkin. This is the primary way to update your drinking history.

### add_comment
Add a comment to a specific checkin. Engage with your friends' latest drinks.

### add_to_wishlist
Put a beer on your personal wishlist. Save it for the next time you're at the store.

### get_beer_activity
Get the activity feed for a specific beer. See how people are reacting to a particular brew.

### get_beer_info
Get detailed information about a specific beer. This includes ABV, IBU, and ratings.

### get_pending_friends
See who has sent you a friend request. Manage your incoming social connections.

## Prompt Examples

**Prompt:** 
```
What are the top trending beers right now?
```

**Response:** 
```
Here are the currently trending beers in the community:

| Category | Trending Beer | Rating |
| :--- | :--- | :--- |
| **Macro** | Bud Light | 3.8 |
| **Micro** | Hazy IPA | 4.2 |
| **Specialty** | Sour Ale | 3.9 |

*Note: These are based on global check-in volume from the last 24 hours.*
```

**Prompt:** 
```
Can you tell me about beer ID 4481?
```

**Response:** 
```
**Beer Details:**

*   **Name:** Anchor Steam Beer
*   **Brewery:** Anchor Brewing Company
*   **Style:** California Common
*   **Stats:** 4.9% ABV, 33 IBU
*   **Rating:** 3.51 (based on 300,000+ check-ins)

Would you like me to add this to your wishlist?
```

**Prompt:** 
```
Who are my friends and what are they drinking?
```

**Response:** 
```
Here is what your friends have been up to:

*   **JohnD** just checked into a **Punk IPA** by BrewDog at *The Craft Bar* (Rating: 4.25).
*   **SarahB** is having a **Guinness Draught** at home.
*   **Mike_Beer** just toasted a **Stout** at *The Taproom*.
```

## Capabilities

### Log beer check-ins
Add a new beer to your drinking history with a simple command.

### Fetch brewery metadata
Get detailed stats, ratings, and descriptions for any brewery.

### Monitor friend activity
See what your friends are drinking in real time via their feeds.

### Search for beers
Look up specific beers in the global database instantly.

### Manage your wishlist
Keep track of beers you want to try by adding or removing them from your list.

### Get trending beers
Stay on top of what's hot in the craft beer scene globally.

## Use Cases

### Quick check-ins at a brewery
You are at a new taproom and want to log a beer. You ask your agent to find the beer's ABV and then use add_checkin to log it instantly.

### Social feed monitoring
You want to see what your friends are drinking today. You ask your agent to pull your friend feed and get a summary of their latest check-ins.

### Brewery research
You are planning a road trip and want to see which breweries are trending. You use get_trending_beers to find the best spots to visit.

### Wishlist cleanup
You want to clean out your to-try list. You ask your agent to remove five specific beers from your list using remove_from_wishlist.

## Benefits

- Update your drinking history instantly by using add_checkin without opening the mobile app.
- Check beer ratings and ABV details on the fly using get_beer_info while you are out at a bar.
- Stay updated on your social circle by pulling friend feeds with get_friend_activity.
- Manage your personal to-drink list easily by using add_to_wishlist and remove_from_wishlist.
- Discover what is hot in the craft beer scene globally with get_trending_beers.
- Research new spots by pulling venue and brewery data with get_venue_info and get_brewery_info.

## How It Works

The bottom line is you get a voice-controlled way to manage your entire beer social profile.

1. Subscribe to the Untappd MCP on the Vinkius marketplace.
2. Input your Untappd Access Token into the configuration settings.
3. Ask your AI client to find a brewery, check into a beer, or see your friends' latest drinks.

## Frequently Asked Questions

**Can I use the Untappd MCP to log my beers?**
Yes, you can use it to add check-ins directly through your AI agent. You just need to describe the beer or provide a name, and the agent handles the rest.

**How do I see what my friends are drinking?**
You can ask your agent to pull your friend feed. It will show you recent check-ins, ratings, and the venues your friends are visiting.

**Can I find breweries near me with this?**
Yes, you can search for breweries by name or location. The agent can then provide you with detailed info on those spots.

**Can I manage my wishlist?**
Yes, you can add beers to your wishlist or remove them using simple commands. It is a great way to keep your 'to-drink' list organized.

**Does this Connector work with my existing account?**
Yes, it connects to your actual Untappd profile. You will just need to provide your access token during the setup process.

**How do I see my badges?**
You can ask your agent to list your user badges. It will show all the achievements and milestones you have earned on your profile.

**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.