# Punk MCP for AI Agents AI Agent Connect > Punk MCP for AI Agents. It connects your agent to the BrewDog beer library, letting it search by ABV, IBU, ingredients, and food pairings to provide expert-level craft beer recommendations and brewing data. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/ai-agent-connect - **Tags:** craft-beer, brewdog, beer-recipes, food-pairing, brewing-data ## Description This craft beer data connector lets your AI agent access the full BrewDog catalog so you don't have to jump between different websites to find craft beer info. Instead of clicking through pages to check alcohol content or bitterness levels, you can just ask your agent to do the digging. It works like a digital sommelier that understands both the technical side of brewing and the culinary side of food pairings. You can ask for a beer that handles the heat in a spicy curry or find specific hop profiles to help with your own homebrewing projects. It pulls data on ABV, IBU, and EBC, making it easy to find exactly what fits your palate. Since it is hosted on Vinkius, you can plug this data into your daily workflow without any setup headaches. It turns your AI into a knowledgeable consultant that knows the specs of hundreds of beers, making it easy to find the right pour for any occasion. You can see full recipes and brewing tips for any beer in the database, which is a huge win for anyone who takes their brewing seriously. It removes the guesswork from both the kitchen and the brewery. ## Tools ### get_beer Get every detail for a specific beer by its ID. This helps you see the full profile, including ABV and hop types, in one place. ### list_beers Search the entire BrewDog catalog with filters like ABV, IBU, or food pairings. Use this to find exactly what you need based on specific taste preferences. ### get_random_beer Get a surprise recommendation from the entire beer collection. This is perfect for when you want to try something new without doing any research. ## Prompt Examples **Prompt:** ``` List some beers that go well with spicy curry. ``` **Response:** ``` I've searched the BrewDog catalog for you. Based on your request for spicy curry, I recommend **Punk IPA** (ID: 192) and **Jack Hammer** (ID: 37). Both have the bitterness and hop profile to balance the heat. Would you like the full details for one of these? ``` **Prompt:** ``` Show me the details for beer with ID 192. ``` **Response:** ``` Fetching details for ID 192... This is **Punk IPA**, a Post Modern Classic with **5.6% ABV**. It features Chinook, Ahtanum, and Nelson Sauvin hops. It pairs perfectly with spicy meat pizza or burgers. Would you like the brewing method details? ``` **Prompt:** ``` Give me a random beer recommendation with an ABV higher than 6%. ``` **Response:** ``` I'll find a strong random brew for you... I've selected **Hardcore IPA** (ID: 15). It has a powerful **9.2% ABV** and **125 IBU**. It's an explicit imperial ale with a massive hop hit. Does this sound like what you're looking for? ``` ## Capabilities ### Filter by technical specs Search the catalog using specific ranges for ABV, IBU, and EBC. ### Identify by ingredients Find beers that contain specific hop varieties, malts, or yeast strains. ### Get instant food pairings Receive tailored beer recommendations for specific cuisines or dishes. ### Access brewing recipes Retrieve full recipes and technical measurements for any beer in the library. ### Discover random brews Let your agent suggest a surprise beer from the entire collection. ## Use Cases ### Finding a pairing for spicy curry A chef asks the agent for a beer that balances heat. The agent uses list_beers to find a high-IBU IPA with specific hop notes. ### Researching hop profiles for homebrewing A brewer wants to know which beers use Chinook hops. The agent scans the catalog to find relevant profiles and brewing tips. ### Testing beverage data structures A developer asks the agent to show the specs for a specific beer ID to verify how the data is structured for their app. ### Finding high-ABV options for a party A host asks for a strong beer recommendation. The agent filters the catalog for high ABV and suggests a few imperial options. ## Benefits - Stop searching multiple sites for beer data by using list_beers to filter by ABV or IBU. - Get instant, data-backed food pairings to help with menu planning or hosting dinner parties. - Access full brewing recipes and technical measurements via get_beer to help with homebrewing projects. - Discover new brews quickly with get_random_beer when you need a fresh idea for your next pour. - Identify specific hop and malt profiles instantly to understand the flavor profile of any beer. ## How It Works The bottom line is you get instant, data-driven beer recommendations and brewing specs directly in your chat. 1. Subscribe to the Punk MCP on Vinkius. 2. Enter 'OPEN' in the token field since it is a public API. 3. Ask your AI client to find beer pairings, recipes, or specific data points. ## Frequently Asked Questions **Can the Punk MCP find beers for specific foods?** Yes. It can search the database for beers that specifically complement different cuisines or dishes, making it a great tool for chefs and hosts. **How does the Punk MCP help homebrewers?** It allows you to quickly look up hop profiles, malt bills, and brewing tips for various beer styles without leaving your research notes. **Can I search for beers by bitterness or alcohol content?** Yes. You can filter the entire catalog by specific ranges for ABV, IBU, and EBC to find exactly the strength or bitterness you want. **Does the Punk MCP include full brewing recipes?** It does. You can retrieve full recipes and technical measurements for any beer in the library to see how it was put together. **Is there a way to get random beer ideas with Punk?** Yes. You can ask your agent to suggest a random beer from the collection whenever you're looking for a new recommendation. **What kind of beer data does the Punk MCP provide?** It provides a wide range of data including ABV, IBU, EBC, ingredient lists, food pairings, and detailed brewing tips. **How can I find beers that pair well with a specific food like 'steak'?** You can use the `list_beers` tool and provide the `food` parameter with your dish name. The agent will return a list of beers from the BrewDog catalog specifically recommended for that pairing. **Can I filter beers by their alcohol percentage (ABV)?** Yes! Use the `list_beers` tool with `abv_gt` (greater than) or `abv_lt` (less than) parameters to find beers within your preferred strength range. **How do I get the full recipe and details for a specific beer ID?** Use the `get_beer` tool and provide the unique integer `id`. The agent will retrieve the complete profile, including ingredients, brewing methods, and technical specifications.