MCP Server

Pour Picks

io.github.bguillow-rgb/pour-picks
Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Searches and compares bourbon and whiskey bottles, provides tasting and pricing data, and recommends bottles by taste, budget, and occasion.

compare_bottles
Side-by-side comparison of two bottles: proof, age, price, flavor profile, shared and distinct tasting notes, and community ratings.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bottle_a', 'bottle_b'], 'properties': {'bottle_a': {'type': 'string', 'maxLength': 200, 'description': 'First bottle â\x80\x94 UUID or name'}, 'bottle_b': {'type': 'string', 'maxLength': 200, 'description': 'Second bottle â\x80\x94 UUID or name'}}, 'additionalProperties': False}
find_cheaper_alternative
Bottles in the same style with a similar flavor profile at a lower price than the given bottle. Great for 'what tastes like X without the price tag' questions.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bottle_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'bottle_id': {'type': 'string', 'maxLength': 120, 'description': 'Bottle UUID or name'}}, 'additionalProperties': False}
find_similar
Bottles with a similar flavor profile to a given bottle, ranked by shared flavor notes and body/sweetness/char proximity. Deterministic scoring over the Pour Picks structured tasting data.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bottle_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'bottle_id': {'type': 'string', 'maxLength': 120, 'description': 'Bottle UUID or name'}}, 'additionalProperties': False}
get_bottle
Detailed record for one bottle: tasting profile, flavor notes, pairings, price, community ratings. Accepts a Pour Picks bottle ID (UUID) or a bottle name.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug_or_id'], 'properties': {'slug_or_id': {'type': 'string', 'maxLength': 120, 'description': "Bottle UUID or a name like 'Eagle Rare 10'"}}, 'additionalProperties': False}
get_recommendations
Personalized bottle picks from taste preferences (flavor keywords like 'caramel', 'smoke', 'cherry'), a budget in USD, and an occasion (e.g. 'gift', 'everyday sipper', 'celebration', 'introducing a friend to bourbon').
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['taste_preferences'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'budget': {'type': 'number', 'minimum': 0, 'description': 'Max price in USD'}, 'category': {'enum': ['bourbon', 'rye', 'tennessee', 'wheat', 'corn', 'american_single_malt', 'scotch_single_malt', 'scotch_blend', 'irish', 'japanese', 'canadian', 'world_whisky', 'rum', 'tequila', 'mezcal', 'cognac', 'armagnac', 'brandy', 'gin', 'vodka', 'other'], 'type': 'string', 'description': 'Restrict to one spirit category'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'What the bottle is for'}, 'taste_preferences': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60}, 'maxItems': 20, 'minItems': 1, 'description': "Flavor keywords the drinker enjoys, e.g. ['caramel','vanilla','oak']"}}, 'additionalProperties': False}
pour_tonight_suggestion
A pour suggestion for right now, based on mood (e.g. 'unwinding', 'celebratory', 'contemplative'), occasion (e.g. 'nightcap', 'with friends', 'after dinner'), and season.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'type': 'string', 'maxLength': 120, 'description': "How you're feeling"}, 'season': {'enum': ['winter', 'spring', 'summer', 'fall'], 'type': 'string', 'description': 'Season to weight the pick toward â\x80\x94 heavier, warming pours in winter; lighter in summer'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'The setting'}}, 'additionalProperties': False}
search_bottles
Full-text search across 4,700+ bourbons, ryes, scotches, and other spirits in the Pour Picks database. Filter by category, price (USD), and proof. Returns structured tasting profiles with source attribution.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}, 'query': {'type': 'string', 'maxLength': 120, 'description': 'Free-text search: distillery, bottle name, or expression'}, 'category': {'enum': ['bourbon', 'rye', 'tennessee', 'wheat', 'corn', 'american_single_malt', 'scotch_single_malt', 'scotch_blend', 'irish', 'japanese', 'canadian', 'world_whisky', 'rum', 'tequila', 'mezcal', 'cognac', 'armagnac', 'brandy', 'gin', 'vodka', 'other'], 'type': 'string', 'description': 'Spirit category filter'}, 'price_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum price in USD'}, 'price_min': {'type': 'number', 'minimum': 0, 'description': 'Minimum price in USD'}, 'proof_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum proof'}, 'proof_min': {'type': 'number', 'minimum': 0, 'description': 'Minimum proof'}}, 'additionalProperties': False}
trending_bottles
Bottles Pour Picks users are adding to their cellars most over the last 30 days (falls back to catalog popularity when live activity data is unavailable). The method used is labeled in the response.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}}, 'additionalProperties': False}
Added
pour_tonight_suggestion
Sept. 17, 2026, 12:40 p.m.
Added
trending_bottles
Sept. 17, 2026, 12:40 p.m.
Added
compare_bottles
Sept. 17, 2026, 12:40 p.m.
Added
get_recommendations
Sept. 17, 2026, 12:40 p.m.
Added
find_cheaper_alternative
Sept. 17, 2026, 12:40 p.m.
Added
find_similar
Sept. 17, 2026, 12:40 p.m.
Added
get_bottle
Sept. 17, 2026, 12:40 p.m.
Added
search_bottles
Sept. 17, 2026, 12:40 p.m.