# VineRadar MCP > VineRadar gives your AI client deep access to global wine data. It lets you search for specific wines by name or keyword, audit entire vineyards by location, and query grape varietals across continents. If you deal in fine wine, collecting, or market research, this MCP instantly converts complex database queries into simple conversation. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** wine-search, vineyard-data, vintage-metadata, beverage-industry, product-discovery ## Description VineRadar hooks your agent directly into vast global wine data, letting you perform deep research without ever opening a dedicated cellar app. You can ask it to pull up details on specific vintages, track regional production by browsing vineyard locations, or discover the distribution of rare grape varietals. It's like having a sommelier who also knows database architecture. Your agent acts as that real-time expert, pulling detailed metadata for anything you need—from simple wine searches to complex market audits. This level of data fidelity is crucial, and because every tool call produces a cryptographically signed audit trail, the history of what your agent found remains tamper-proof. Whether you're building out a personal collection guide or running industry research, this MCP organizes technical varietal data into clean, usable facts that flow straight to your workflow. ## Tools ### check_api_status Confirms whether the entire VineRadar system is currently running and available for use. ### get_vineyard_details Retrieves all technical details associated with a single vineyard ID you provide. ### get_wine_details Pulls up every piece of available data for one specific wine, using its unique identifier. ### list_wine_varietals Returns a full list of all grape types supported by the VineRadar catalog. ### search_vineyards Finds vineyards based on a general location or region name you give it. ### search_wines Searches for wines using any keyword, like a brand name or wine style, and gets initial results. ## Prompt Examples **Prompt:** ``` Search for 'Cabernet Sauvignon' wines using VineRadar. ``` **Response:** ``` I've retrieved 10 Cabernet Sauvignon wines. Notable labels include high-rated bottles from Napa Valley and Bordeaux. Would you like the full details for the top matches? ``` **Prompt:** ``` Find vineyards in 'Napa Valley'. ``` **Response:** ``` I've identified 5 premium vineyards in Napa Valley. Notable locations include 'Silver Oak' and 'Stag's Leap'. I can provide the specific IDs for these vineyards if you'd like. ``` **Prompt:** ``` What are the details for wine ID 12345? ``` **Response:** ``` I've identified wine ID 12345 as a 2018 Reserve Merlot. It has a rating of 4.5 stars and is noted for its smooth finish. Would you like to see the vineyard metadata or similar varietals? ``` ## Capabilities ### Search for Specific Wines Your agent finds thousands of wines using names or keywords and returns detailed metadata like ratings and vintages. ### Locate Vineyards by Area It pulls up full profile details on vineyards, letting you map out regional wine production areas. ### List Grape Varietals The agent gives you a list of every supported grape type and where it's grown globally. ### Get Detailed Wine Info You can request deep-dive data for any specific wine ID, including its full history and metadata. ### Deep Dive on Vineyards It retrieves all the technical details attached to a single vineyard using only its unique identifier. ## Use Cases ### Market Research on Grape Trends A consultant needs to know if Pinot Noir is becoming more common in Oregon. They ask their agent, and it uses `list_wine_varietals` to confirm the grape's global presence before running targeted searches. ### Building a Cellar Guide A collector wants details on every wine from the 'Stag's Leap' region. They use `search_vineyards` first, then loop through results and run `get_wine_details` for each relevant ID. ### Inventory Audit A merchant needs to check if any wines matching 'Cabernet Sauvignon' are available in a new market. They use `search_wines` and get a list of potential inventory matches immediately. ## Benefits - When you need to know what grapes are even available, use `list_wine_varietals` to pull up every supported type in one go. You don't have to guess. - Checking a specific bottle? Just give the ID and let `get_wine_details` retrieve all metadata, saving you from cross-referencing multiple tabs. - Planning a trip or expanding a catalog? Use `search_vineyards` first; it lets you map out potential sourcing regions by location. - Can't find that specific vintage? Running `search_wines` with a keyword will surface top matches, giving you quick results even if you don't have the exact name. - Need to confirm everything is working before running a big job? Just run `check_api_status`. It verifies the connection status instantly. ## How It Works The bottom line is you talk naturally to your agent, and it handles all the complex API calls behind the scenes. 1. Subscribe to this MCP and enter your API key credentials. 2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent a question like 'Search for Merlot wines from Bordeaux' to start retrieving data. ## Frequently Asked Questions **How do I find wines by location using VineRadar?** You start by running `search_vineyards` with a location name. This gives you the vineyard ID, which you can then use to pull specific details via `get_vineyard_details`. **Can I check if my wine data is reliable using VineRadar?** Yes, you should always run `check_api_status` first. This confirms the entire MCP connection is active and functioning before you start your research. **What does search_wines do with keywords?** `search_wines` handles general keyword searches, letting you pull up a list of potential wines that match a style or brand name, even if you don't have the exact title. **How do I get deep info on one wine using VineRadar?** You use `get_wine_details`. Just provide the unique wine ID, and it returns all available metadata for that specific bottle or vintage. **What should I use if I need to check the current operational status of VineRadar using the `check_api_status` tool?** Running `check_api_status` confirms that the core VineRadar API is live and ready for requests. This ensures your AI agent can connect successfully before running complex searches, saving you time on failed calls. **How do I view a complete list of all supported wine varietals using the `list_wine_varietals` tool?** The `list_wine_varietals` tool returns a comprehensive catalog of every grape type recognized by VineRadar. This is useful for market research, helping you quickly identify specific trends or regional focuses without needing to search for them individually. **If I already have the identifier, how do I get full data on one vineyard using the `get_vineyard_details` tool?** Providing a Vineyard ID directly to the `get_vineyard_details` function bypasses location searching. You receive immediate, deep information about that specific site's production history and metadata. **When running large or repeated queries using `search_wines`, how is performance optimized by the MCP?** The Vinkius platform handles token optimization on every call. This built-in feature cuts down on data transfer size, keeping your agent's workflow fast and efficient even when searching massive volumes of wine records. **How do I find my VineRadar API Key?** Log in to your [**VineRadar dashboard**](https://vineradar.com/account), and you will find your API Key under the 'Integrations' or 'Developer' section. Copy and paste it below. **Can the agent search for vineyards by region?** Yes. Use the `search_vineyards` tool providing the location name (e.g., 'Napa Valley' or 'Bordeaux'). Your agent will return matching vineyards instantly. **Is vintage information included?** Yes. The wine records retrieved by your agent include the vintage year and specific characteristics associated with that production cycle.