Bar Assistant MCP Server
A high-performance cocktail search and recipe retrieval server that integrates with Bar Assistant instances to provide intelligent cocktail discovery through natural language queries.
๐ Smart Cocktail Search - Natural language queries with similarity matching for finding drinks by name, ingredient, base spirit, flavor profile, or ABV. Filter by ABV ranges, glassware types, preparation methods, alcohol strength preferences (light/medium/strong), and flavor profiles (bitter/sweet/sour/spicy/herbal). Returns complete recipes with auto-converted measurements, step-by-step instructions, and specifications.
๐ Recipe Retrieval - Single or batch lookup by name or database ID with flexible mixing of both. Retrieve up to 20 recipes simultaneously with parallel processing for 5-10x performance improvement. Includes detailed ingredients with precise measurements, instructions, ABV, glassware, garnishes, and direct database links. Optionally include similar cocktails and variations for exploration.
๐งช Ingredient Intelligence - Comprehensive ingredient research including descriptions, flavor profiles, tasting notes, substitution guidance with flavor impact analysis, and complete recipes featuring the ingredient.
โก Performance Features - Parallel API processing, intelligent caching system with 70%+ hit rate (<50ms for cached responses), error resilience where individual failures don't break batch operations, configurable limits (up to 50 search results, 20 recipes), and detailed performance metrics tracking.
Use Cases: "What cocktails can I make with gin and vermouth?", "Show me the recipe for a Manhattan", "Find bitter cocktails with ABV over 25%", "What is Campari and what can I make with it?", "Give me cocktails like a Negroni"
Enables natural language interactions with Bar Assistant cocktail databases, allowing queries for cocktail recipes, ingredient searches, and recommendations through AI assistants.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bar Assistant MCP Serverwhat cocktails can I make with rum and lime?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bar Assistant MCP Server
A high-performance Model Context Protocol (MCP) server that provides intelligent cocktail search and recipe retrieval from Bar Assistant instances.
Features
๐ Smart Cocktail Search - Natural language queries with similarity matching
๐ Complete Recipes - Detailed ingredients, instructions, and specifications
๐ฏ Similarity Engine - Discover cocktails similar to your favorites
๐งช Ingredient Analysis - Find cocktails by ingredients, flavors, and characteristics
โก Batch Processing - Retrieve multiple recipes simultaneously (5-10x faster)
๐พ Smart Caching - Intelligent caching with 70%+ hit rate
๐ง Advanced Filtering - ABV ranges, glassware, preparation methods, and more
Related MCP server: Cocktail By Api Ninjas
Prerequisites
Docker and Docker Compose
Access to a Bar Assistant instance
Bar Assistant API token
Running with Docker
The only supported method for running the server is with Docker Compose.
Create an
.envfile:Create a file named
.envin the root of the project and add the following, replacing the placeholder values with your actual Bar Assistant configuration:BAR_ASSISTANT_URL=https://your-instance.com BAR_ASSISTANT_TOKEN=your-api-token BAR_ASSISTANT_BAR_ID=1Get Your Bar Assistant API Token:
Log into your Bar Assistant instance
Navigate to Settings โ API
Generate a new API token
Copy the token and paste it into the
BAR_ASSISTANT_TOKENfield in your.envfile.
Build and start the container:
docker-compose up --build -dThe server will be available at
http://localhost:3001.
PourOver API Gateway
This server includes an integrated API Gateway to support the PourOver mobile application, providing natural language query streaming using Google Antigravity CLI (agy).
Endpoint:
POST /queryAuthentication: Secured with
MCP_SSE_TOKENpassed via thex-api-keyheader (or standard Authorization/query parameters).Format: Takes a JSON body
{"query": "your query"}and streams response chunks back intext/plain.
Usage
Once configured, you can interact with the server through your MCP client. Here are some example queries:
"What cocktails can I make with gin and vermouth?"
"Show me the recipe for a Manhattan"
"Give me recommendations on cocktails like a Negroni"
"What ingredients do I need to buy to make these 5 cocktails?"
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables management of your home bar inventory and cocktail discovery through Bar Assistant. View shelf ingredients, find cocktails you can make, and add or remove items from your bar collection.6
- AlicenseCqualityDmaintenanceEnables searching for cocktail recipes by name or ingredients using the API Ninjas Cocktail API, supporting partial matches and ingredient-based filtering.161MIT
- Flicense-qualityDmaintenanceProvides cocktail recommendations using a Retrieval-Augmented Generation (RAG) pipeline powered by LangChain, FAISS, and Groq. It enables users to search for cocktail recipes and receive personalized drink suggestions through natural language.
- FlicenseAqualityDmaintenanceEnables natural language search for cocktail recipes and ingredient information through TheCocktailDB API. Supports searching by cocktail name, ingredient, category, or alcohol content to discover recipes and recommendations.5
Related MCP Connectors
Search your knowledge bases from any AI assistant using hybrid RAG.
Cocktails MCP โ TheCocktailDB API (free, no auth)
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhdenny/bar-assistant-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server