PunkAPI Connector for AI agents.
8 live capabilities
Find craft beer data and food pairings for your next menu or homebrew project.
Waiting for input…
Why people use PunkAPI
PunkAPI Craft Beer Data for Menu Planning
With PunkAPI, you can just ask your agent to do the work. You can pull a list of beers that pair with 'spicy' food or find all the stouts in a specific ABV range. You get a curated list of options in seconds instead of spending an hour on research.
What Vinkius changes
You get a direct line to a massive beer catalog without any manual searching.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Creating a food pairing menu
A restaurant owner needs to create a pairing menu for a new steak dinner.
- Real-world use case 02
Researching hop profiles
A homebrewer wants to see what hops are commonly used in West Coast IPAs.
- Real-world use case 03
Finding session beers
A bar manager wants to see every beer in the catalog that has a low ABV for a 'session' flight.
Complete set · 8capabilities
The complete PunkAPI capability set.
These are the exact actions your AI can choose when you ask it to work with PunkAPI.
01—04
4 capabilities in this set.
Part of 8 available through PunkAPI.
- 01 Capability
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.
- 02 Capability
Get beers by hops
Search for beers that feature specific hop varieties like Citra or Mosaic. This lets you research specific flavor profiles.
- 03 Capability
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.
- 04 Capability
Get beers by abv
Filter the catalog for session beers or high-alcohol options based on your range. This balances your tap list quickly.
05—08
4 capabilities in this set.
Part of 8 available through PunkAPI.
- 05 Capability
Get beers by food
Find specific beers that pair well with items like cheese, burgers, or spicy food. This speeds up menu planning.
- 06 Capability
Get beers by ibu
Locate beers based on bitterness levels, from mild to very bitter. This finds the right balance for your palate.
- 07 Capability
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.
- 08 Capability
Get random beer
Grab a random selection of beers for new discovery. This finds something new to try today.
Set up in minutes
One URL. Then ask PunkAPI to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use PunkAPI from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it PunkAPI, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable PunkAPI for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the PunkAPI URL.
- Step 03
Save and start
Save the connection and enable PunkAPI in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"punkapi": {
"url": "https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using PunkAPI
Open Agent mode in chat and ask: "Using PunkAPI, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"punkapi": {
"url": "https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using PunkAPI
Ask Copilot: "Using PunkAPI, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"punkapi": {
"url": "https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using PunkAPI
Open Cascade and ask: "Using PunkAPI, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"punkapi": {
"url": "https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using PunkAPI
Ask Cline: "Using PunkAPI, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add punkapi --transport http "https://edge.vinkius.com/vk_preview_KHd6J6NLRdDnWNKGDKXue7jfEc8yGXGxOD5c061f/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using PunkAPI
Ask Claude: "Using PunkAPI, show me...". 8 tools are ready
Where the request belongs
Work PunkAPI can move forward.
Brewers, restaurant owners, and craft beer enthusiasts who need accurate data for menu planning, recipe research, or discovery.
Restaurant Owner
They use this to build balanced drink menus that pair perfectly with their signature food items.
Homebrewer
They research hop profiles and malt types to refine their own custom brewing recipes.
Beer Enthusiast
They use it to find new beers to try based on their specific taste preferences for bitterness or style.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPunk
Explore the BrewDog beer catalog. search by ingredients, food pairings, and technical specs like ABV or IBU.
Untappd
Track beers, breweries, and venues. Access check-in feeds, beer metadata, and manage your social drinking profile directly from your AI agent.
Open Brewery DB
Search and discover craft breweries worldwide. find locations, types, and contact info via AI.
TheCocktailDB
Access a massive database of cocktail recipes and ingredients. search by name, filter by alcohol content, and discover new drinks.
CocktailFyi
Explore cocktails, ingredients, and bartending techniques. get recipes and guides via AI.
Cocktail API
Search cocktail recipes. audit ingredients and instructions via AI.
Bring your own AI
Change the model, client or framework. Keep PunkAPI connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about PunkAPI.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to PunkAPI.
Connect PunkAPI once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available