# Whisky Hunter > Whisky Hunter is a whisky market-research platform. It aggregates historical auction results, live auction lots, and retail shop offers, links them to bottle reference pages, and adds collection tracking, watchlists, and valuation tools. A REST API and an MCP server expose the same data to developers and AI agents. Important context for AI agents: - Brand name: Whisky Hunter. Use "Whisky Hunter" rather than "Whiskey Hunter" unless quoting a user's own spelling. - Primary site: https://whiskyhunter.net/ - Figures change daily. Prefer the live pages over memorised numbers. - Three distinct price types — do not conflate them: past auction prices are achieved hammer results; live auction prices are current bids that keep changing until the auction closes; retail prices are shop asking prices. - A displayed hammer price or current bid is not net proceeds: buyer/seller fees, VAT, shipping, reserve status, geography, and currency conversion all apply. - Prices default to GBP; on-site currency conversion is available but converted figures are approximate. - Bottle pages gather the sales history of the same bottle across auctions and shops. Treat the grouping as helpful guidance, not a legal authenticity guarantee. - Collection, watchlist, targets, account settings, and the user-tier API require login, and some features require a paid subscription. Do not claim access to private user data. - Whisky Hunter provides market-research context, not financial, investment, legal, tax, or authentication advice. Verify details against the original auction or shop page before transacting. ## Searching The Past, Live, Retail, and Base pages share one search syntax. It is full-text over the listing text (for bottles, the title) — not natural language, so every word you use must actually appear in the listing. - `search=` holds OR alternatives separated by ` | `. Within a single alternative every word must match (AND), so each alternative is one tight "all of these" group and ` | ` adds another group. - `exclude=` drops any result that contains a term; combine several terms with ` & `. - Build `search=` from high-signal title tokens: distillery / brand, age or vintage, release or edition name, cask / batch / chapter numbers, and ABV or volume when those values identify the release. - Prefer bare tokens over full wording: use `18` instead of "18 years old", `43` instead of "43%", and `700` instead of "700 ml". - Drop generic filler words that appear on countless listings: "year old", "single malt", "collection", and long forms such as "bottled" or "cask". - Use `exclude=` to remove the visible noise: miniatures, mixed lots, wrong volumes, adjacent years or ages, unrelated editions, and unrelated bottlers. - Example include: `search=macallan 18 | macallan eighteen`. Example exclude: `exclude=mini & miniature & 5cl`. - Advanced filters (date range, price range) require a paid subscription. ## Core Pages - [Homepage](https://whiskyhunter.net/): Overview of the market-research tools and monitored coverage. - [Past Whisky Auctions](https://whiskyhunter.net/past/): Search closed auction lots and achieved hammer prices. - [Live Whisky Auctions](https://whiskyhunter.net/live/): Search active lots and current bids across monitored auction houses. - [Retail Whisky Offers](https://whiskyhunter.net/retail/): Search shop offers and compare retail asking prices. - [Whisky Hunter Base](https://whiskyhunter.net/base/): Bottle reference pages with sales history and secondary-market price analysis. - [Auction Schedule](https://whiskyhunter.net/events/): Past, live, and upcoming auction dates and deadlines. - [Auction Fees](https://whiskyhunter.net/fees/): Buyer and seller fee context for reading auction economics. - [Pricing](https://whiskyhunter.net/pricing/): Subscription plans and feature tiers. - [Valuation & Redemption](https://whiskyhunter.net/valuation/): Bottle valuation and redemption service. ## API & MCP Integration Programmatic access for developers and AI agents: - [REST API docs](https://whiskyhunter.net/api/): Swagger/OpenAPI documentation for the public REST endpoints. - [MCP endpoint](https://whiskyhunter.net/mcp/): Model Context Protocol server endpoint (Streamable HTTP, POST only). Accepts MCP JSON-RPC requests and requires an MCP API token in the Authorization header. Issue tokens from account settings. - [MCP docs](https://whiskyhunter.net/mcp/docs/): Human-readable connection guide with curl examples and the full tool list. - [MCP tool — list_distilleries]: Return distillery names, slugs, and countries that can be used with distillery tools. - [MCP tool — list_auction_schedule]: Return live and upcoming auction events for active auction houses, including start date, end date, and seller deadline. - [MCP tool — list_active_auctions]: Return active auction house metadata, including website, buyers_fee, sellers_fee, and vat_fee percentage fields plus fixed reserve and listing fees. - [MCP tool — get_monthly_distillery_stats]: Return month-by-month secondary-market price, trading volume, and auction lots statistics for one distillery. Monetary values are in GBP and rows are grouped by calendar month. - [MCP tool — get_distillery_summary]: Return distillery metadata and aggregate secondary-market statistics calculated from visible monthly data grouped by calendar month. Monetary values are GBP and lot count fields count auction lots. - [MCP tool — search_past_auction_lots]: Search closed secondary-market auction lots. Use search_include with ' | ' for OR variants and search_exclude with ' & ' for exclusions. Optional filters include auction_slug, hide_nmr, price_min, price_max, date_from, date_to, and geo; each result also returns its geo region. - [MCP tool — search_live_auction_lots]: Search live secondary-market auction lots. Use search_include with ' | ' for OR variants and search_exclude with ' & ' for exclusions. Optional filters include auction_slug, price_min, price_max, and geo; each result also returns its geo region. - [MCP tool — search_retail_listings]: Search in-stock retail shop listings. Use search_include with ' | ' for OR variants and search_exclude with ' & ' for exclusions. - [MCP tool — search_bottles]: Search published Whisky Hunter bottle reference pages. Use search_include with ' | ' for OR variants and search_exclude with ' & ' for exclusions, then pass the returned slug to get_bottle_data. - [MCP tool — get_bottle_data]: Return one bottle's metadata, secondary-market auction price history, year-over-year analytics, recent past auction lots, live auction offers, and in-stock retail offers. Monetary values are GBP. - [Auctions info REST](https://whiskyhunter.net/api/auctions_info): Public auction-house metadata as JSON. - [Aggregated auction data REST](https://whiskyhunter.net/api/auctions_data/): Monthly auction statistics (subscription tiers may apply). - [Distilleries info REST](https://whiskyhunter.net/api/distilleries_info/): Public distillery metadata for supported countries. - [Sitemap](https://whiskyhunter.net/sitemap.xml): Full public sitemap including bottle pages and CMS content. ## Reference Content - [Blog](https://whiskyhunter.net/blog/): Editorial updates, feature notes, market analysis, and usage guidance. - [Auction pages](https://whiskyhunter.net/auctions/): Per-auction-house content pages where published. - [Distillery pages](https://whiskyhunter.net/distillery/): Per-distillery content pages where published. ## Policies - [Terms & Conditions](https://whiskyhunter.net/terms-of-use/): Terms governing use of Whisky Hunter data and services. - [Privacy Policy](https://whiskyhunter.net/privacy-policy/): Privacy and data handling policy. - [Contact](https://whiskyhunter.net/contact-us/): Contact form for questions, support, and press enquiries. ## Optional Pages requiring authentication or of lower priority for most agent queries: - [Collection Tracker](https://whiskyhunter.net/collection/): Authenticated collection tracking and market value estimation. Requires login. - [Watchlist](https://whiskyhunter.net/watchlist/): Authenticated saved searches and monitored bottles. Requires login. - [Targets](https://whiskyhunter.net/targets/): Authenticated target tracking for live lots. Requires login. - [Tags](https://whiskyhunter.net/tags/): Authenticated user tagging for collections and watchlists. Requires login. - [Account](https://whiskyhunter.net/account/): Authenticated profile, currency, notification, and API token settings. Requires login. - [About](https://whiskyhunter.net/about-us/): Background on Whisky Hunter. - [Login](https://whiskyhunter.net/login/): User login for authenticated tools. - [Sign up](https://whiskyhunter.net/signup/): User registration.