Punk API Connector for AI agents.
3 live capabilities
Find the perfect craft beer pairings and brewing specs.
Waiting for input…
Why people use Punk API
Use Punk to find craft beer pairings and brewing data
With the Punk MCP, your agent does the heavy lifting. You just describe the meal or the brewing goal, and it pulls the exact specs you need in seconds.
What Vinkius changes
You get instant, data-driven beer recommendations and brewing specs directly in your chat.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding a pairing for spicy curry
A chef asks the agent for a beer that balances heat.
- Real-world use case 02
Researching hop profiles for homebrewing
A brewer wants to know which beers use Chinook hops.
- Real-world use case 03
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.
Complete set · 3capabilities
The complete Punk API capability set.
These are the exact actions your AI can choose when you ask it to work with Punk API.
01—03
3 capabilities in this set.
Part of 3 available through Punk API.
- 01 Capability
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.
- 02 Capability
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.
- 03 Capability
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.
Set up in minutes
One URL. Then ask Punk API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Punk API 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_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Punk API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API URL.
- Step 03
Save and start
Save the connection and enable Punk API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"punk": {
"url": "https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API
Open Agent mode in chat and ask: "Using Punk API, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"punk": {
"url": "https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API
Ask Copilot: "Using Punk API, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"punk": {
"url": "https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API
Open Cascade and ask: "Using Punk API, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"punk": {
"url": "https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API
Ask Cline: "Using Punk API, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add punk --transport http "https://edge.vinkius.com/vk_preview_QowAx5BDU8fTaKYeLZ4IQjH01Tqkue58ehdWmwDy/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 Punk API
Ask Claude: "Using Punk API, show me...". 3 tools are ready
Where the request belongs
Work Punk API can move forward.
This is for homebrewers who need quick access to hop profiles, chefs looking for precise menu pairings, and developers building beverage apps.
Homebrewer
Checking hop profiles and malt bills while drafting new recipes on a Tuesday afternoon.
Chef
Finding the perfect craft beer to pair with a new spicy curry recipe for a weekend menu.
App Developer
Testing beer-related data structures and API responses in a conversational environment.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPunkAPI
Explore BrewDog's beer catalog. search by name, style, ABV, IBU, hops, food pairing and get random beer suggestions.
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.
Vinsight
Manage wine, beer, and spirits production. inventory, sales orders, batches, vessels, and lab results for your Vinsight operation through natural conversation.
Bring your own AI
Change the model, client or framework. Keep Punk API 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 Punk API.
The practical details behind the request, access and result.
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 capability 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 capability 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 capability 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 capability and provide the unique integer id. The agent will retrieve the complete profile, including ingredients, brewing methods, and technical specifications.
One connection away
Give your agent a direct line to Punk API.
Connect Punk API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available