Pour Picks MCP Server
Click on "Deploy 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., "@Pour Picks MCP Server recommend a wheated bourbon under $60 for a gift"
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.
Pour Picks MCP Server
Query the Pour Picks bourbon & whiskey database from Claude, or any MCP-compatible AI client. Read-only access to 4,700+ bottles with structured tasting profiles, prices, pairings, and community ratings.
Pour Picks is the bourbon collector's journal for iOS — get it on the App Store.
Tools
Tool | What it does |
| Full-text catalog search with category, price, and proof filters |
| Full record for one bottle (by ID or name): tasting profile, price, pairings, community ratings |
| Bottles with a similar flavor profile, ranked by shared notes and body/sweetness/char proximity |
| Same style, similar profile, lower price |
| Picks from flavor preferences + budget + occasion |
| Side-by-side: proof, age, price, shared and distinct flavors, ratings |
| What Pour Picks users are adding to their cellars right now |
| A pour for tonight, from mood, occasion, and season |
Every response includes source attribution, a citation-ready summary line, links, and data freshness dates. All scoring is deterministic — no AI calls happen inside the server.
Related MCP server: Alko MCP Server
Install (Claude Desktop)
Requires Node.js 18+.
Add to your claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config):
{
"mcpServers": {
"pour-picks": {
"command": "npx",
"args": ["-y", "pour-picks-mcp"]
}
}
}Restart Claude Desktop. No API key or configuration needed — the server ships with public read-only access.
From a local checkout
{
"mcpServers": {
"pour-picks": {
"command": "node",
"args": ["/path/to/pour-picks/mcp-server/dist/index.js"]
}
}
}Configuration (optional)
The server works with zero configuration using Pour Picks' public read-only key. Environment variables override the defaults:
Variable | Purpose |
| Override the database URL |
| Internal use only — unlocks live 30-day cellar-add trending. Never distribute this key. |
Without the service key, trending_bottles falls back to catalog popularity and labels the method in its response (method: "catalog_popularity_tier" vs "cellar_adds_last_30_days").
Remote endpoint (no install)
Streamable HTTP for web agents and MCP clients that take a URL:
https://nqnigdqkcvrziwcbgily.supabase.co/functions/v1/mcpAlso listed on Smithery (gateway pour-picks--bguillow.run.tools) and the official MCP registry as io.github.bguillow-rgb/pour-picks.
Example agent requests
Questions an agent can answer with these tools:
"What bourbon is similar to Eagle Rare but easier to find?" →
find_similar"Recommend a bourbon under $60 with vanilla, oak, and caramel notes." →
get_recommendationswithtaste_preferences: ["vanilla","oak","caramel"], budget: 60"What tastes like Blanton's without the price tag?" →
find_cheaper_alternative"Compare Eagle Rare and Buffalo Trace." →
compare_bottles"What bourbon should I pour on a cold night?" →
pour_tonight_suggestionwithseason: "winter""What bottles are collectors adding right now?" →
trending_bottles
Example response shape (truncated):
{
"cheaper_alternatives": [
{ "name": "Buffalo Trace W.L. Weller 12 Year", "price_usd": 49.99,
"similarity": 0.78, "savings_usd": 15.0,
"shared_flavors": ["caramel", "oak"] }
],
"attribution": {
"source": "Pour Picks — The Bourbon Collector's Journal",
"links": { "website": "https://pourpicks.app/" }
}
}Development
npm install
npm run dev # run from TypeScript via tsx
npm run build # compile to dist/
npm start # run compiled serverThe server speaks MCP over stdio. Catalog access is read-only by construction: every query path issues SELECTs against tables that are publicly readable under row-level security, and it is rate-limited to 60 calls/minute.
Usage telemetry: each tool call logs the tool name, its arguments, client name/version, duration, and success/failure to a write-only log table (insert-only under RLS; contents are not publicly readable). No user identity, account data, or conversation content is collected. Logging is fire-and-forget and never affects responses.
Publishing
npm:
npm publishfrom this directory (themcpNamefield in package.json links the package to the registry entry).MCP Registry:
server.jsonin this directory is the registry manifest. Publish with themcp-publisherCLI after the npm package is live:mcp-publisher login github && mcp-publisher publish.
Data & attribution
Bottle data, tasting profiles, and pairings are curated by Pour Picks. Quote freely with attribution:
Source: Pour Picks — The Bourbon Collector's Journal (pourpicks.app)
Community rating counts are included with every rating so you can judge sample size. Freshness dates on each bottle reflect the last enrichment pass.
Available Tools
8 toolscompare_bottlesCompare two bottlesARead-onlyIdempotentInspect
Side-by-side comparison of two bottles: proof, age, price, flavor profile, shared and distinct tasting notes, and community ratings.
Inputs: bottle_a (required), bottle_b (required).
find_cheaper_alternativeFind a cheaper alternativeARead-onlyIdempotentInspect
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.
Inputs: bottle_id (required), limit.
find_similarFind similar bottlesARead-onlyIdempotentInspect
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.
Inputs: bottle_id (required), limit.
get_bottleGet bottle detailsARead-onlyIdempotentInspect
Detailed record for one bottle: tasting profile, flavor notes, pairings, price, community ratings. Accepts a Pour Picks bottle ID (UUID) or a bottle name.
Inputs: slug_or_id (required).
get_recommendationsGet personalized recommendationsARead-onlyIdempotentInspect
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').
Inputs: taste_preferences (required), limit, budget, category, +1 more.
pour_tonight_suggestionWhat should I pour tonight?ARead-onlyIdempotentInspect
A pour suggestion for right now, based on mood (e.g. 'unwinding', 'celebratory', 'contemplative'), occasion (e.g. 'nightcap', 'with friends', 'after dinner'), and season.
Inputs: mood, season, occasion.
search_bottlesSearch the Pour Picks catalogARead-onlyIdempotentInspect
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.
Inputs: limit, query, category, price_max, +3 more.
trending_bottlesTrending bottlesARead-onlyIdempotentInspect
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.
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: searching, fetching a bottle, finding similar or cheaper alternatives, personal recommendations, comparison, trending, and a mood-based pour suggestion. Even nearby functions like find_similar and find_cheaper_alternative are differentiated by their price constraint.
Most tools follow a verb_object or verb_adjective pattern like search_bottles, get_bottle, compare_bottles, and find_similar. trending_bottles and pour_tonight_suggestion break the imperative pattern slightly, but the naming is otherwise clear and predictable.
Eight tools is a well-scoped set for a spirits discovery and recommendation server. Each tool provides a meaningful capability without unnecessary overlap or bloat.
The tool set covers the primary workflows: browsing, searching, retrieving details, finding alternatives, comparing, getting personalized recommendations, and seeing popular picks. There are no obvious gaps for a read-only bottle discovery and recommendation domain.
Maintenance
Related MCP Connectors
Aircraft intelligence for AI agents: valuations with uncertainty bands, FAA registry lookups, cost of ownership, comparable aircraft, fleet search, airworthiness directives and STCs, market metrics and forecasts, verified value reports, pre-buy diligence checklists, logbook search and a watchlist. 38 tools; free tier with OAuth or a Windsock API key.
Search, inspect, recommend, and explain rated AI tools through Agent Radar.
Search 2,000+ AI tools: pricing, alternatives, comparisons, and live, dead or acquired status.
Independent directory of agentic AI tools — search, compare & recommend via MCP. Read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables intelligent cocktail discovery and recipe retrieval from Bar Assistant instances with natural language search, similarity matching, batch processing, and ingredient analysis capabilities.33MIT
- AlicenseAqualityDmaintenanceProvides AI assistants with access to Finland's Alko alcohol product catalog, enabling product search across 11,900+ items, store availability checks, Vivino ratings lookup, and personalized recommendations based on food pairings and preferences.917MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the Open Brewery DB API, allowing AI assistants to search for breweries and retrieve detailed information like location, type, and contact details. It enables interactive exploration of a global database containing over 40,000 breweries.36 npm1MIT
- AlicenseAqualityNot gradedmaintenanceProvides access to over 2.5 million US alcohol label records from the TTB via the COLA Cloud API. It enables users to search for labels by brand, barcode, or permit holder and retrieve detailed product information including label images and ABV.6MIT