MCP-Server

Pour Picks

io.github.bguillow-rgb/pour-picks
Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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').
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Hinzugefügt
pour_tonight_suggestion
17. September 2026 12:40
Hinzugefügt
trending_bottles
17. September 2026 12:40
Hinzugefügt
compare_bottles
17. September 2026 12:40
Hinzugefügt
get_recommendations
17. September 2026 12:40
Hinzugefügt
find_cheaper_alternative
17. September 2026 12:40
Hinzugefügt
find_similar
17. September 2026 12:40
Hinzugefügt
get_bottle
17. September 2026 12:40
Hinzugefügt
search_bottles
17. September 2026 12:40