# PunkAPI MCP for AI Agents AI Agent Connect

> PunkAPI lets you explore a massive craft beer catalog. Search for beers by name, style, ABV, IBU, hops, and food pairings. Get random suggestions or deep details on ingredients and brewing tips for any beer in the collection.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/ai-agent-connect
- **Tags:** craft-beer, beverage-data, food-pairing, catalog-search, api-integration

## Description

PunkAPI lets you talk to a massive catalog of craft beers without having to dig through spreadsheets or websites. If you're trying to figure out which beer goes best with a spicy curry or a block of sharp cheddar, you can just ask your agent to find the perfect match. It handles the heavy lifting of filtering by alcohol content, bitterness, and specific hop varieties. You'll get back real details like brewing tips, ingredient lists, and even specific food pairings. It's a great way to pull data into your projects quickly. You can find this in the Vinkius marketplace and get started without needing any complex API keys. This tool is designed for those who need to move past surface-level descriptions and get into the weeds of what makes a beer unique. You can query for specific malt types, look for certain hop profiles like Citra or Mosaic, or find beers that fit a very specific bitterness range. It turns a research task that usually takes dozens of clicks into a single conversation with your agent.

## Tools

### get_beer_by_id
Get full details for a specific beer including ingredients and brewing tips. This gives you the exact malt and hop profile.

### get_beers_by_hops
Search for beers that feature specific hop varieties like Citra or Mosaic. This lets you research specific flavor profiles.

### get_all_beers
Search the entire catalog using multiple filters like name, color, and date. This lets you perform a deep dive into the full collection.

### get_beers_by_abv
Filter the catalog for session beers or high-alcohol options based on your range. This balances your tap list quickly.

### get_beers_by_food
Find specific beers that pair well with items like cheese, burgers, or spicy food. This speeds up menu planning.

### get_beers_by_ibu
Locate beers based on bitterness levels, from mild to very bitter. This finds the right balance for your palate.

### get_beers_by_style
Browse the catalog by popular styles like IPA, Stout, or Lager. This shows all options in a specific category at once.

### get_random_beer
Grab a random selection of beers for new discovery. This finds something new to try today.

## Prompt Examples

**Prompt:** 
```
Give me a random beer suggestion.
```

**Response:** 
```
I found a great suggestion for you:

**Punk IPA**
* **ABV:** 5.4%
* **IBU:** 35
* **Profile:** A post-modern classic. Juicy, tropical, and citrusy.
* **Key Hops:** Cascade, Amarillo, and Centennial
* **Food Pairing:** Pairs perfectly with spicy Indian food.

Would you like to see more details on the ingredients or similar styles?
```

**Prompt:** 
```
Find me beers that pair well with cheese.
```

**Response:** 
```
I found 15 beers that pair well with cheese. Here are some highlights:

| Beer Name | Style | Notes |
| :--- | :--- | :--- |
| **Dead Pony Club** | Light, Session | Great for lighter cheeses |
| **5AM Saint** | Amber Ale | Pairs well with aged cheddar |
| **Hardcore IPA** | Strong IPA | Good for sharp, bold flavors |
| **Tokyo Rising** | Dark, Intense | Perfect for blue cheese |

Let me know if you'd like to see the full list or filter them by ABV.
```

**Prompt:** 
```
Show me all BrewDog IPAs.
```

**Response:** 
```
I've pulled the IPA selection from the catalog. Here are some of the top options:

* **Punk IPA** (5.4% ABV, Classic)
* **Elvis Juice** (6.5% ABV, Grapefruit notes)
* **Hazy Jane** (5% ABV, New England style)
* **Punk AF** (0.5% ABV, Non-alcoholic)
* **Lost Lager** (4.5% ABV)

Each of these includes full hop profiles and specific food pairings. Would you like me to dive deeper into one of these?
```

## Capabilities

### Find beers by food pairings
Get a list of beers that complement specific foods like cheese, burgers, or spicy dishes.

### Filter by alcohol content
Search for session beers or high-alcohol options using specific ABV ranges.

### Get detailed brewing specs
Access full ingredient lists, yeast types, and brewing tips for specific beers.

### Get random beer ideas
Receive a random selection of beers from the catalog for new discovery.

### Search by hop varieties
Filter the catalog by specific hops like Citra, Mosaic, or Galaxy.

### Search by beer style
Browse the catalog by popular categories like IPA, Stout, Lager, or Sour.

## Use Cases

### Creating a food pairing menu
A restaurant owner needs to create a pairing menu for a new steak dinner. They ask their agent to find beers that pair with 'pork' and 'bbq' using get_beers_by_food.

### Researching hop profiles
A homebrewer wants to see what hops are commonly used in West Coast IPAs. They use get_beers_by_hops to see which varieties show up most often.

### Finding session beers
A bar manager wants to see every beer in the catalog that has a low ABV for a 'session' flight. They use get_beers_by_abv to get the list.

### Random beer discovery
A beer lover is bored with their usual order. They ask for a random suggestion and use get_random_beer to find something new to try.

## Benefits

- Find the perfect meal accompaniment by using get_beers_by_food to match beers with specific ingredients like cheese or BBQ.
- Identify specific hop profiles for your next batch by searching hop varieties with get_beers_by_hops.
- Balance your tap list by filtering for specific alcohol percentages with get_beers_by_abv.
- Get deep technical specs like yeast types and malt lists for any beer using get_beer_by_id.
- Save time on menu research by using get_beers_by_style to pull all options for a specific category like Stout or Lager.
- Keep your discovery fresh by pulling a new selection of drinks using get_random_beer.

## How It Works

The bottom line is you get a direct line to a massive beer catalog without any manual searching.

1. Connect PunkAPI to your Vinkius dashboard.
2. Ask your agent to find beers based on specific criteria like ABV or hops.
3. Get a curated list of results with full ingredients and pairing tips.

## Frequently Asked Questions

**How can I use PunkAPI to find beers for a cheese board?**
You can ask your agent to find beers that specifically pair with cheese. It will return a list of matching beers along with their specific pairing suggestions.

**Can PunkAPI help me find low alcohol beers?**
Yes, you can filter the catalog by ABV range to find session beers or other lower-alcohol options quickly.

**Does PunkAPI include information on hop varieties?**
It does. You can search for beers that feature specific hops like Citra, Mosaic, or Galaxy to see their full profiles.

**Can I get random beer suggestions with PunkAPI?**
Absolutely. You can ask for a random selection to discover new beers from the catalog without having to search for anything specific.

**How do I filter beers by bitterness using PunkAPI?**
You can search by IBU range. This allows you to find beers that match your preference, whether you want something mild or very bitter.

**Can PunkAPI search for specific beer styles like Lagers?**
Yes, you can browse the entire catalog by style to see all available options for categories like Lagers, Stouts, or IPAs.

**Does PunkAPI provide food pairing ideas?**
Yes, the data includes specific food pairings for beers, making it easy to find the right drink for your next meal.

**Do I need an API key?**
No! PunkAPI is completely free and open. No authentication required. Just subscribe and start searching beers.

**What does ABV and IBU mean?**
ABV (Alcohol By Volume) measures alcohol content percentage. IBU (International Bitterness Units) measures bitterness: 60 = very bitter.