# Tolstoy MCP

> Tolstoy connects your AI agent directly to interactive video experiences. Build and manage full shoppable video funnels—from uploading raw media assets to tracking conversion rates and revenue impact through natural conversation. Use this server to list videos, query analytics, check project statuses, and organize your entire library without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** interactive-video, shoppable-video, video-marketing, customer-engagement, video-funnels, media-management

## Description

Listen up. This server connects your AI agent straight into Tolstoy, letting you run full-blown shoppable video funnels and manage massive media libraries right from your chat window. You don't have to jump between dashboards; your agent handles everything conversationally.

**Managing Your Video Funnels**
You can list all the interactive projects with `list_interactive_projects`. This tool gives you a rundown of every branching video funnel you’ve set up—the whole pipeline, not just one clip. You're controlling complex decision paths here. 

**Handling Assets and Media Organization**
To keep your content organized, your agent uses `list_folders` to map out the entire top-level folder structure of your video assets. Need a full view? Call `list_videos`, and you get a complete catalog listing every single video uploaded to your library. If you need more media, your agent imports it directly using `upload_video`, pulling new video files from an external URL straight into the Tolstoy system.

**Tracking Performance and Status**
To know if your funnels are actually making money, call `get_video_analytics`. This pulls detailed performance metrics on specific videos, giving you plays counts, conversion rates, and total revenue impact. It’s how you measure success. You can verify which real-time notification endpoints are active and configured by running `list_webhooks`; this confirms your e-commerce system is connected for immediate alerts.

It's all about control. Your agent uses these tools to list videos, manage entire funnels, upload new assets, check project statuses, query analytics, and organize the whole damn library—all without leaving your chat client.

## Tools

### get_video_analytics
Pulls detailed performance metrics like play counts and conversion rates for your videos.

### list_folders
Lists the top-level folder structure where your video assets are stored.

### list_interactive_projects
Provides a list of all configured, branching video funnels you've built in Tolstoy.

### list_videos
Fetches a comprehensive catalog view of every single video asset uploaded to your library.

### list_webhooks
Displays which real-time notification endpoints are currently set up and active in Tolstoy.

### upload_video
Imports a new video file from an external URL directly into your Tolstoy media library.

## Prompt Examples

**Prompt:** 
```
List all videos in my Tolstoy library.
```

**Response:** 
```
I've retrieved your video library. You have 12 videos including 'Customer Testimonial', 'Product Walkthrough', and 'Founder Welcome'. Which one would you like to see analytics for?
```

**Prompt:** 
```
Show me the analytics summary for my videos.
```

**Response:** 
```
I've fetched your performance summary. Over the last 30 days, your interactive videos have received 1,500 plays with an average conversion rate of 8.5%. Would you like a breakdown by specific video?
```

**Prompt:** 
```
Upload this video to Tolstoy: 'https://vinkius.com/intro.mp4' with name 'Introduction v2'.
```

**Response:** 
```
Import initiated! I've triggered the upload of 'Introduction v2' to your library. It should be available in your Tolstoy dashboard for interactive flow building shortly.
```

## Capabilities

### Analyze Video Performance
Retrieves metrics on plays, conversion rates, and revenue impact for specific videos.

### Manage Interactive Flows
Lists all configured branching video projects (funnels) you've set up in Tolstoy.

### Browse Asset Library
Shows the entire catalog of uploaded videos or lists specific folders to organize your media assets.

### Import New Content
Uploads a new video asset to Tolstoy from an external URL for use in funnels.

### Check Webhook Status
Verifies which real-time notification endpoints are currently active and configured.

## Use Cases

### Checking post-campaign performance
The E-commerce Manager needs to know if the 'Summer Sale' video funnel worked. They ask their agent, and the agent runs `get_video_analytics`. The resulting data summary shows a conversion rate of 12% for that specific project, allowing immediate action without manual reporting.

### Onboarding new assets
A Content Creator finishes a product walkthrough video. Instead of logging into the Tolstoy dashboard, they simply prompt their agent to `upload_video` using the external link and name it 'Product Walkthrough V3'. The asset is immediately available for use.

### Reviewing funnel structure
The Marketing Manager needs to know if there are any outdated or forgotten video funnels. They ask their agent to `list_interactive_projects`. The agent returns a list, allowing the manager to spot and decommission old paths efficiently.

### Ensuring data flow is live
The Ops Engineer suspects that real-time purchase events aren't being logged. They prompt their agent to run `list_webhooks`. The agent confirms the webhook is active, or flags it if a configuration change broke the connection.

## Benefits

- Get instant performance data. Instead of jumping into the analytics dashboard, ask your agent to run `get_video_analytics` and get an immediate summary of plays and conversion rates.
- Maintain a clean asset structure. Use `list_folders` or `list_videos` to see everything in one command, instantly knowing where every piece of media lives without clicking through the UI.
- Audit your funnels quickly. Run `list_interactive_projects` when you need to know how many branching paths exist and what they are called—no navigating menus required.
- Scale content effortlessly. You can use `upload_video` to import new videos from a URL, letting the agent handle the media ingestion so your team doesn't get bogged down in manual uploads.
- Verify system connections instantly. Use `list_webhooks` to confirm that Tolstoy is sending real-time notifications to your e-commerce backend when needed.

## How It Works

The bottom line is: you treat complex media management tasks—like checking analytics or listing assets—as simple conversations with your AI client.

1. Subscribe to the Tolstoy server on Vinkius.
2. Enter your API Key into your AI client's settings.
3. Ask your agent a natural language command, like 'Show me the conversion rate for my latest product video,' and it runs the necessary tool call.

## Frequently Asked Questions

**How do I check video analytics with Tolstoy MCP Server?**
You use `get_video_analytics`. Simply tell your agent you need the performance metrics for a specific campaign, and it retrieves plays, conversion rates, and revenue data.

**What is the best way to list videos in my Tolstoy library?**
Use `list_videos` when you want a complete catalog of all assets. If you only want to see what folders are available for organization, run `list_folders` instead.

**How do I upload a new video using the Tolstoy MCP Server?**
You trigger the `upload_video` tool. You just need to provide an external URL and a name; the agent handles importing it into your library for funnels.

**Can I check if my webhooks are working with list_webhooks?**
Yes, `list_webhooks` confirms which notification endpoints are configured. This is crucial to make sure real-time data flows back to your e-commerce system.

**How does the `list_folders` tool help me organize my video assets?**
It lists all defined folders within your Tolstoy account. This lets you see how your marketing assets are structured, helping you keep track of different campaign groups or content types.

**What is the purpose of `list_interactive_projects` in my workflow?**
This tool retrieves a list of all your branching video flows and interactive experiences. You can use this to query, manage, and confirm which complex projects are active in your account.

**What credentials do I need to connect the Tolstoy MCP Server?**
You must provide a valid Tolstoy API Key. This key is found in your account settings and authorizes your AI client agent to interact with your video data.

**How can I get a full view of my stored media using the available tools?**
You combine `list_folders` and `list_videos`. First, use list folders to understand the structure. Then, you can list specific videos within those organized groups for a complete asset overview.

**Can I see the conversion rate for my interactive videos via AI?**
Yes! Use the `get_video_analytics` tool. Your agent will retrieve detailed performance metrics, including plays and the percentage of users who converted through the interactive elements.

**How do I import a new video into my library using the AI?**
Use the `upload_video` action and provide the public URL of the video file. You can also specify an optional name for the video in your Tolstoy library.

**Is it possible to list all my branching video projects?**
Absolutely. Use the `list_interactive_projects` tool to retrieve a directory of all your interactive flows and branching video experiences.