# VineRadar MCP for AI Agents AI Agent Connect > VineRadar lets you search wines and vineyards while auditing varietals and vintages via your AI agent. It pulls real-time data on wine ratings, vineyard locations, and grape types so you can build a personal cellar or conduct market research without jumping between different wine apps. It turns your AI into a data-driven sommelier. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_kGA6zGAIOimvr0inil3QWygka3KNem0cYL1RYlnI/ai-agent-connect - **Tags:** wine-search, vineyard-data, vintage-metadata, beverage-industry, product-discovery ## Description VineRadar connects your AI agent to a massive database of global wine and vineyard information. Instead of manually digging through different websites to find specific grape varieties or vineyard locations, you can just ask your agent to do the heavy lifting. It handles the tedious work of pulling vintage metadata, checking wine ratings, and identifying regional trends. You'll be able to build detailed wine lists, audit your current collection, or research market movements through a simple conversation. It's designed to turn your AI into a real-time sommelier that knows the technical details of every varietal. When you use this Connector through the Vinkius catalog, you get a direct line to structured wine data that stays updated. This means you spend less time copy-pasting facts and more time making decisions about your wine portfolio or hospitality operations. You can query specific vineyard profiles to understand regional production or search for specific labels to see how they stack up against others. It handles the data retrieval so you can focus on the curation. Whether you are organizing a private tasting or managing a commercial inventory, the agent provides the specific details you need without the friction of manual searching. This tool makes it easy to organize complex wine data into a clear, actionable format for your specific needs. ## Tools ### get_vineyard_details Fetches complete information for a specific vineyard using its ID. It's the fastest way to get deep location data. ### check_api_status Verifies that the VineRadar connection is active. This ensures your agent has a clear path to the data. ### get_wine_details Retrieves all available metadata for a specific wine ID. Use this to get ratings and vintage specifics in one go. ### list_wine_varietals Shows every wine varietal currently in the VineRadar database. It's great for seeing what's trending or available. ### search_vineyards Finds vineyards based on their geographical location. This helps you map out specific regional wine production. ### search_wines Locates wines using any name or keyword. It works as the primary way to find specific labels in the catalog. ## Prompt Examples **Prompt:** ``` Find some high-rated wines from Bordeaux. ``` **Response:** ``` I found the following high-rated wines from Bordeaux: | Wine Label | Vintage | Rating | Key Notes | | :--- | :--- | :--- | :---| | **Château Margaux** | 2015 | 4.8 | Elegant tannins, notes of blackcurrant. | | **Château Lafite** | 2016 | 4.7 | Structured, deep fruit profile. | | **Château Pavie** | 2017 | 4.6 | Vibrant acidity, smooth finish. | Would you like more details on any of these? ``` **Prompt:** ``` Where are the vineyards in Napa Valley? ``` **Response:** ``` I've identified several premium vineyards in Napa Valley: * **Silver Oak** (ID: 9921) * **Stag's Leap** (ID: 8832) * **Far Niente** (ID: 7741) I can provide the specific metadata for these locations if you'd like to see more. ``` **Prompt:** ``` What are the details for wine ID 12345? ``` **Response:** ``` Here are the details for wine ID 12345: * **Name:** 2018 Reserve Merlot * **Rating:** 4.5 Stars * **Notes:** Known for its smooth finish and rich body. * **Vintage:** 2018 Would you like to see the vineyard metadata or similar varietals? ``` ## Capabilities ### Find specific wines by name or keyword Locate any wine label in the database to see its ratings and vintage details. ### Get full vineyard profiles by location Pull detailed information on specific vineyards based on their geographic region. ### Identify regional grape variety distributions See which grape types are most common in specific wine-producing regions. ### Pull detailed vintage metadata for specific IDs Retrieve deep data for a single wine ID to audit your personal collection. ### Monitor trending wine varietals List all supported varietals to see what themes are currently popular. ### Check the VineRadar connection status Verify that your agent is successfully connected to the wine data source. ## Use Cases ### Building a high-rated wine menu A sommelier needs to find high-rated wines from a specific region for a new menu. They ask the agent to search for "Napa Valley Cabernet" and get a ranked list. ### Identifying trending wine themes A wine merchant wants to see which varietals are currently trending. They use the agent to list all varietals and identify common themes. ### Auditing a specific vintage collection A collector wants to know the specifics of a 2018 Merlot. They provide the ID and get the rating and finish notes immediately. ### Mapping regional wine production An ops lead needs to audit a hotel's wine list. They ask the agent to find all vineyards in France to check regional variety. ## Benefits - Skip manual searches by using `search_wines` to find specific labels instantly. - Get deep location insights by pulling vineyard profiles with `search_vineyards`. - Understand regional trends by listing all available varietals with `list_wine_varietals`. - Audit your cellar accurately by pulling vintage metadata with `get_wine_details`. - Save time on research by checking the `check_api_status` before starting large data pulls. ## How It Works The bottom line is you get instant access to a global wine database through a natural conversation with your AI. 1. Subscribe to the VineRadar MCP on Vinkius 2. Enter your VineRadar API Key in your client settings 3. Ask your agent to find wines, vineyards, or varietals ## Frequently Asked Questions **Can VineRadar help me build a wine list?** Yes, it allows your AI agent to search the global wine database to find specific labels, ratings, and varietals to help you curate a professional list quickly. **How do I find specific vineyards with VineRadar?** You can simply ask your agent to find vineyards in a specific location. It will pull the profiles and IDs for you automatically. **Does VineRadar work for wine merchants?** It is ideal for merchants who need to audit regional distributions, check varietal availability, and monitor market trends across a large catalog. **Can I get ratings for specific wines using VineRadar?** Yes, your agent can retrieve full metadata for specific wine IDs, which includes current ratings and vintage-specific details. **What kind of varietals are included in VineRadar?** The Connector can list all supported wine varietals in the catalog, helping you identify regional trends and variety distributions. **Is VineRadar good for personal cellar audits?** It is perfect for collectors who want to pull detailed vintage metadata for their specific wine IDs to keep their records accurate and organized. **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.