How to Use the Tolstoy MCP in OpenAI Agents SDK

Q: How do I search for video data using Tolstoy with OpenAI Agents SDK?

Your agents use the listvideos tool to query all available content. You can then pass those results to other tools to get specific metrics, like calling getvideoanalytics on a particular asset.

Q: Can I list all projects with Tolstoy using OpenAI Agents SDK?

Yep, you can use listinteractiveprojects to see every project available. It gives you a map of all the shoppable video experiences set up on your site.

Q: What if I need to upload a video using Tolstoy with OpenAI Agents SDK?

You simply call uploadvideo. The tool manages the full lifecycle of getting the video onto the platform. It makes sure the asset is correctly indexed for your funnels.

Run shoppable video funnels with your OpenAI Agents SDK. Deploy interactive e-commerce experiences, safely.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Tolstoy MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Video Performance Metrics

Need to know how a specific piece of content is performing? Call `get_video_analytics` to pull performance metrics for your video assets. This gives you the hard numbers on engagement. You can track exactly what's working and where visitors drop off in your shoppable funnels.

Manage Video Content Library

Starting with `list_videos`, you get a full inventory of all videos hosted by the MCP Server. This lets your agent know exactly what content is available for embedding. If you need to add something new, just use `upload_video`. The system handles the storage and preparation so it’s ready for action.

Control Webhook Connections

Your agent can manage external connections using `list_webhooks`. It shows you every configured webhook, keeping track of where your video data is being sent. Need to check if the connection is still live? You'll see all details right there. This keeps your e-commerce funnels connected and running.

Setup guide

Set up Tolstoy 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 Tolstoy tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Tolstoy 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="Tolstoy Agent",
            instructions="You have access to Tolstoy 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 Tolstoy. 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 Tolstoy 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 Tolstoy MCP in OpenAI Agents SDK

Your agents use the `list_videos` tool to query all available content. You can then pass those results to other tools to get specific metrics, like calling `get_video_analytics` on a particular asset.

The MCP Server handles video performance metrics and webhook configurations. These are the key pieces of information your agent will interact with while managing e-commerce funnels.

Yep, you can use `list_interactive_projects` to see every project available. It gives you a map of all the shoppable video experiences set up on your site.

The system is designed to manage various endpoints, allowing one deployment to service multiple needs. Your agent's context manager handles the connections safely.

You simply call `upload_video`. The tool manages the full lifecycle of getting the video onto the platform. It makes sure the asset is correctly indexed for your funnels.

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