# Teyuto MCP

> Teyuto MCP Server gives your AI client direct access to a video streaming platform's entire backend. Use it to audit user accounts, pull granular video analytics (watch time, views), list content collections, and manage channel metadata—all without logging into the dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** teyuto, vod-api, video-streaming-automation, live-streaming-tools, content-manage, subscriber-management, media-analytics, white-label-video, mcp

## Description

You're connecting your AI client to Teyuto via MCP. This gives your agent direct backend access, letting you run full audits on a professional video streaming platform without ever having to log into the dashboard yourself.

First things first: Run `check_teyuto_status`. That confirms your API connection is actually live and working before you start pulling data.

**Auditing Video Content & Metadata:**
To map out all the content, use `list_videos` to pull a complete list of every video asset. You can filter or sort this massive list using its metadata fields. When you've found a specific asset ID, run `get_video` to grab the full, deep metadata sheet for that single file. If you need to view all the videos grouped by their content grouping, start with `list_collections`, which returns a paginated rundown of every video collection available on the platform. You can then drill down into any specific group using `get_collection` and inputting its unique ID.

**Tracking Performance:**
You want to know how well your videos are performing? Run `get_video_analytics`. By feeding it a specific video's ID, you pull hard metrics like total accumulated watch time and precise view counts. This gives you the performance data for any given asset.

**Mapping Out Structure & Users:**
To understand the entire platform structure, use `list_channels` to see all available channels. You can also run `list_users` to pull a comprehensive list of every registered account on Teyuto. If you need details on one specific person's profile—say, to check their status or join date—you run `get_user`, passing in the user ID.

**Platform Operations:**
For business context, use `list_subscriptions` to see what pricing plans and features are currently available. You don't need a specific tool for general listing; your agent can compile everything by combining calls: you list all channels via `list_channels`, get the full metadata on every video using `get_video`, run analytics via `get_video_analytics` for performance checks, pull user lists with `list_users`, and map out content groupings using `list_collections` and then detailing each one with `get_collection`. It’s a complete toolset to audit the entire backend structure.

## Tools

### check_teyuto_status
Verifies that the API connection to Teyuto is active and functional.

### get_collection
Retrieves full details for a specific video collection ID.

### get_user
Fetches detailed information about an individual user account by ID.

### get_video_analytics
Pulls specific performance metrics, like watch time and view counts, for a given video.

### get_video
Retrieves the full metadata for a single video file or asset.

### list_channels
Provides a list of all available channels on the platform.

### list_collections
Returns a paginated list of all existing video collections.

### list_subscriptions
Lists current subscription plans, including pricing and features.

### list_users
Retrieves a complete list of all registered users on the platform.

### list_videos
Lists all video assets, allowing filtering and sorting by metadata fields.

## Prompt Examples

**Prompt:** 
```
List all my videos.
```

**Response:** 
```
You have 45 videos. Top 3 by views: 'Getting Started' (12.3k views), 'Advanced Tips' (8.1k), 'Q&A Session' (5.7k).
```

**Prompt:** 
```
Show analytics for video vid_001.
```

**Response:** 
```
Video 'Getting Started': 12,340 views, 4,567 hours watch time, 78% completion rate, 92% positive engagement.
```

**Prompt:** 
```
List all video collections.
```

**Response:** 
```
You have 5 collections: 'Beginner Series' (8 videos), 'Pro Tips' (12 videos), 'Live Sessions' (6 videos).
```

## Capabilities

### Audit Video Content
List all available videos or pull deep metadata for a single video using `list_videos` or `get_video`.

### Track Performance Metrics
Execute `get_video_analytics` to retrieve specific metrics like total views and accumulated watch time for any video ID.

### Manage Users and Accounts
List all registered users (`list_users`) or pull a detailed profile on one user using `get_user`.

### Map Content Structure
View the relationships between content by listing video collections (`list_collections`), individual videos (`list_videos`), and available channels (`list_channels`).

### Check Platform Status
Run `check_teyuto_status` to verify API connectivity before running any complex data queries.

## Use Cases

### Auditing User Growth
A Product Owner needs to know how many users signed up this week. They ask their agent, which runs `list_users`. The agent returns a list of 450 IDs and can then pull targeted data using `get_user` for the top 10 new sign-ups, solving the need without touching the admin dashboard.

### Content Gap Analysis
A Content Strategist needs to know if their 'Beginner Series' collection has enough content. They call `list_collections` to find the ID, then use `get_collection`, and finally run `list_videos` on that ID to count assets against a target of 15 videos.

### Performance Deep Dive
The Marketing team wants to know if their latest video campaign was successful. They ask the agent, which runs `get_video_analytics` on the specific campaign's ID. The result immediately provides watch time and view counts for a rapid report.

### Platform Health Check
A Platform Ops Engineer needs to confirm if the video API is working before running a massive sync job. They first execute `check_teyuto_status` to get an immediate success or failure response, preventing a full system breakdown.

## Benefits

- Stop manually running reports. Use `get_video_analytics` to feed your agent specific metrics—like completion rates and hours watched—so it can generate a performance summary instantly.
- Audit entire user bases with one call. Instead of navigating through dashboards, run `list_users` and `get_user` to quickly audit accounts or check for missing metadata across the platform.
- Map out your content library structure. Run `list_collections` and then `get_collection` to understand how videos are grouped without manually clicking into every folder.
- Understand monetization options by running `list_subscriptions`. Your agent processes this data, telling you which plans are active and what features they include.
- Get granular video details immediately. If you just need the title and dimensions for a single piece of content, call `get_video` instead of listing everything with `list_videos`.

## How It Works

The bottom line is: you bypass the UI by having your agent call specific backend functions to pull exactly the data you need.

1. Tell your AI client the specific data you need (e.g., 'What are the top 5 videos by view count last month?').
2. Your agent determines which tools to run (like `list_videos` and then `get_video_analytics`) and executes them against the Teyuto API.
3. The server returns raw structured data, which your AI client processes into a readable report or summary.

## Frequently Asked Questions

**How do I find out how many videos are on my platform using Teyuto MCP Server?**
You run `list_videos`. This tool retrieves all video assets and provides a count of the items, allowing you to know your total inventory size immediately.

**Can I get analytics for a specific video ID with Teyuto MCP Server?**
Yes. Use `get_video_analytics` and provide the unique video ID. This call returns detailed metrics like watch time, view counts, and engagement rates.

**What if I need to see all available channels on Teyuto?**
Simply call `list_channels`. This tool retrieves a comprehensive list of every channel ID and name that exists within your platform structure.

**How does Teyuto MCP Server help with user management?**
It gives you two tools: `list_users` to get a roster of all accounts, or `get_user` if you need the specific details (like account status) for one ID.

**How do I use the `list_subscriptions` tool to check available pricing plans on Teyuto?**
Use `list_subscriptions` to pull current plan data. This tool provides detailed information on feature sets, pricing tiers, and billing cycles across your platform.

**Before I run big queries, how can I use `check_teyuto_status` to verify API connectivity?**
Running `check_teyuto_status` immediately confirms if the connection is live. This simple check verifies that your agent has active access to the Teyuto platform before you attempt complex data pulls.

**What should I do first with `list_collections` when managing grouped video content?**
Run `list_collections` to get a roster of all existing video groupings. Once you have the name or ID, use `get_collection` to pull full metadata and see exactly which videos belong inside.

**If I need more than just basic details for an account, how does `get_user` help with user profile data?**
`get_user` pulls deep profile records for a specific ID. This lets your agent access granular information like join dates, roles, and associated metrics that simple listing tools won't show.

**Can my AI show video analytics?**
Yes. `get_video_analytics` returns view counts, watch time, and engagement data for any video.

**How do I browse video collections?**
Use `list_collections` to see all collections, then `get_collection` for details including its videos.

**Can I list users and check subscriptions?**
Yes. `list_users` shows all users and `list_subscriptions` shows all plans with pricing.