How to Use the Wine-Searcher MCP in Pydantic AI

Q: How does Pydantic AI handle complex wine lookups with Wine-Searcher?

It forces structure. When you run winecheck, the output is validated against a rigid schema, so your agent always receives consistent data types for scores, regions, and pricing.

Q: Can Pydantic AI compare prices across multiple producers using Wine-Searcher?

Yes. When you gather data from marketprice or producerinfo, the validation layer ensures that all comparable fields (like currency and date ranges) are correctly typed before your agent performs the comparison.

Q: Does Pydantic AI support searching for available wines using Wine-Searcher?

Absolutely. The structured response from searchwines means you can build workflows that treat the results as guaranteed, typed records. No messy parsing needed.

Build reliable wine intelligence agents with Pydantic AI's strict type safety.

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 Pydantic AI

Create your Vinkius account to connect Wine-Searcher to Pydantic AI 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 Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Ensure correct data on global pricing.

When you run `wine_check`, the resulting data is immediately validated against Pydantic models. If the Wine-Searcher MCP Server returns a field that's missing or formatted wrong, your agent fails loudly—you know exactly what went wrong. This type safety keeps your code clean. You can trust that any pricing data received via `market_price` will match the expected structure for reliable financial reporting.

Validate complex winery and regional details.

Building a profile requires accurate inputs. When using `producer_info`, Pydantic ensures all required fields are present, meaning you never process an incomplete or corrupted brand record. Similarly, when getting `region_info` for terroir analysis, the strict schema guarantees that every geographical detail is correctly typed and structured before your agent uses it.

Process search results with guaranteed structure.

The most common use case—finding a wine—is handled by `search_wines`. Because Pydantic validates the output, you get reliable access to scores and availability data every time. Even when running deep lookups for specific grapes via `grape_info`, the structured response means your agent can immediately map that information into other validated records without any guesswork.

Setup guide

Set up Wine-Searcher MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "wine-searcher-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Wine-Searcher tools.",
)

result = await agent.run("List recent Wine-Searcher transactions")
print(result.output)

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 Pydantic AI

It forces structure. When you run `wine_check`, the output is validated against a rigid schema, so your agent always receives consistent data types for scores, regions, and pricing.

Yes. When you gather data from `market_price` or `producer_info`, the validation layer ensures that all comparable fields (like currency and date ranges) are correctly typed before your agent performs the comparison.

It’s excellent for building reliable educational content. When combining `grape_info` and `region_info`, you know with certainty that the data points—like alcohol percentage or historical context—are all correctly formatted.

Absolutely. The structured response from `search_wines` means you can build workflows that treat the results as guaranteed, typed records. No messy parsing needed.

It handles commercial metadata, specifically global wine pricing and merchant inventory levels. The primary goal is guaranteeing the structural integrity and correctness of this non-personal market data.

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