How to Use the CellarPass MCP in OpenAI Agents SDK

Connect CellarPass to OpenAI Agents SDK via MCP to manage winery bookings and guest history through constrained, production-ready agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CellarPass MCP to OpenAI Agents SDK

Create your Vinkius account to connect CellarPass to OpenAI Agents SDK 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 CellarPass with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe CellarPass MCP Server interactions

Your OpenAI agent needs guardrails before it touches live booking data. Passing this server to your agent constructor exposes `list_reservations` and `check_availability` to the system, but you maintain control over execution. The SDK validates every request to make sure the agent does not overbook your tasting room. When a host asks who is coming today, the agent hits the endpoint and streams the response back. You can trace the exact sequence in your OpenAI dashboard to see how it handled the request. Set cacheToolsList to true so you skip fetching the schema on every run.

Route VIP guests automatically

Tasting room managers rely on `search_guests` to pull visit history and spending habits. You can build a routing system where a general concierge agent fetches the guest profile, then hands off high-value clients to a specialized VIP agent. The handoff happens natively within the framework. Your specialized agent then uses `get_experience` to suggest specific reserve tastings based on what the guest bought last year. It keeps your hospitality personalized without manual record digging.

Map out multi-location wineries

Operations teams running several tasting rooms need a unified view. Calling `list_venues` gives your agent the layout, while `get_venue` pulls specific details about each location's operating hours and capacity. Combine this with `list_experiences` to build a complete map of what is happening across your entire estate. The agent auto-discovers these tools, meaning you spend zero time writing boilerplate API wrappers to get this data into your Python backend.

Setup guide

Set up CellarPass MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all CellarPass tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives CellarPass tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate CellarPass tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="CellarPass Agent",
            instructions="You have access to CellarPass tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 CellarPass. 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 CellarPass 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 CellarPass MCP in OpenAI Agents SDK

Install the package and pass the Vinkius MCP endpoint token. Create an MCPServerStreamableHttp instance and hand it directly to your Agent constructor.

The current toolset focuses entirely on retrieving operational data. Your agent reads availability and guest history, but it will never accidentally delete a reservation.

You skip writing integration code completely. The SDK auto-discovers all eight tasting room tools immediately, saving you weeks of development time.

Yes. Enable cacheToolsList in your parameters. This stops the agent from requesting the tool definitions every single time it boots up.

Vinkius runs the connection in an ephemeral V8 Isolate Sandbox. When your agent pulls spending history or VIP status, that information flows through a zero-trust tunnel directly to your environment.

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