eCommerce
winegenie.com
An MCP server for searching and exploring UK wine merchant listings, with semantic wine discovery, mixed-case building, alternatives, and product details to support purchasing.
ENDPOINT 1
https://winegenie.com/mcp
MCP server metadata
- Name
- winegenie
- Version
- 0.1.0
WineGenie is a UK wine catalogue for AI agents: merchant listings with structured attributes (grapes, taste scales, food pairings, drinking windows), prices and delivery from approved UK merchants, and purchase links. Use search_wine when the request reduces to attributes (grape, region, price, colour); semantic_wine_search when it does not ("something obscure and natural for a picnic"); best_for for "what goes with X" or an occasion; build_case for several bottles at once, which gets them from one merchant and one delivery; alternatives when a wine turns out to be unbuyable; get_product for full detail on one wine; compare for side-by-side. Always show the buy_url from the result when recommending a wine. Prices are in GBP per bottle unless case_size says otherwise; quote the merchant and the price_seen_at date. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. critic_score is a critic score reported by the merchant, not a customer rating. data_confidence (0–1) says how sure we are about the attributes; below 0.5 means mostly inferred from grape and region. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
Known tools 7
search_wineSearch UK merchant listings of wine by free text plus optional structured filters.
Inferred read-onlysemantic_wine_searchFind wines from a description of the occasion, mood or style rather than exact attributes: "something obscure and natural for a picnic", "a crowd-pleaser for a barbecue that is not too heavy", "like Barolo but cheaper".
Inferred read-onlybuild_caseAssemble a mixed case that a SINGLE merchant can ship, so the buyer pays one delivery instead of one per bottle.
Inferred read-onlyalternativesWines closest in taste and price to one you already have, for when it is out of stock, over budget, or the user wants something similar.
Inferred read-onlyget_productFull detail on one product by product_id (UUID) or slug from a previous result or a winegenie.com/wine/{slug} URL: every attribute with its provenance, all offers with delivery terms, drinking window, decanting, pairings, and the buy_url.
Inferred read-onlycompareSide-by-side comparison of 2 to 5 products by product_id or slug: colour, style, grapes, origin, vintage, taste scales (body, acidity, tannin, sweetness, oak on 1–5), ABV, farming, food, drink window, decant, critic score, cheapest offer, data confidence.
Inferred read-onlybest_forCurated shortlist (up to 8) for a dish ("roast lamb", "sushi", "cheese board") or an occasion ("gift", "Christmas", "BBQ", "dinner party", "midweek"), optionally within a budget ("under £20" or a number in GBP).
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.winegenie]
url = "https://winegenie.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"winegenie": {
"type": "http",
"url": "https://winegenie.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: winegenie
Remote MCP URL: https://winegenie.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"winegenie": {
"url": "https://winegenie.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"winegenie": {
"type": "http",
"url": "https://winegenie.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "winegenie",
"transport": "streamable-http",
"url": "https://winegenie.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.