How to Use the Wine-Searcher MCP in Windsurf

Q: How can I use Wine-Searcher and Windsurf to compare global pricing?

You just tell Cascade the wine name. It will run marketprice across all available merchants, giving you a side-by-side comparison of costs instantly. You don't need to know which merchant is best.

Q: Can Windsurf help me find regional information for Wine-Searcher?

Absolutely. If you mention a region, Cascade uses regioninfo to pull deep details on the appellation and terroir. It's great for understanding why a wine tastes a certain way.

Q: If I have multiple producers, can Wine-Searcher and Windsurf compare them?

You can use producerinfo to pull research data on different wineries and brands. Then, you feed that context into other tools for direct comparison.

Figure out the perfect wine pairing and market value, autonomously powered by Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wine-Searcher MCP to Windsurf

Create your Vinkius account to connect Wine-Searcher to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Wine-Searcher with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-step Discovery for Wine-Searcher

Need to find a gift? Cascade handles the whole process. You set your goal, and it uses `search_wines` to pull matching options based on criteria you give. It doesn't just list names; it gives scores, pricing data, and tells you which merchants are actually carrying the bottles.

Deep Lookup using Wine-Searcher

`wine_check` is your go-to tool for any wine question. Cascade feeds all necessary parameters—like grape variety, region, or alcohol content—into this function to get a full data dump. This lets you instantly check global pricing and critic scores from 100,000+ merchants without writing a line of code.

Contextual Analysis with Wine-Searcher

Want to know more about the background? Cascade can chain `grape_info` and `region_info` together. You get detailed knowledge on terroir or specific variety profiles. This is perfect for building educational content or giving a sommelier presentation, letting your agent pull related context automatically.

Setup guide

Set up Wine-Searcher MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Wine-Searcher MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Wine-Searcher payment history." If connected, Cascade will call the Wine-Searcher tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "wine-searcher-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Wine-Searcher. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Wine-Searcher now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Wine-Searcher MCP in Windsurf

You just tell Cascade the wine name. It will run `market_price` across all available merchants, giving you a side-by-side comparison of costs instantly. You don't need to know which merchant is best.

Absolutely. If you mention a region, Cascade uses `region_info` to pull deep details on the appellation and terroir. It's great for understanding *why* a wine tastes a certain way.

Yes. If you need wines that meet specific criteria—say, high alcohol content from a particular grape in a certain region—Cascade handles the multi-filter logic using `search_wines`.

The server touches pricing, critic scores, grape varieties, regions, and producer name. It's a deep set of consumer product records.

You can use `producer_info` to pull research data on different wineries and brands. Then, you feed that context into other tools for direct comparison.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript