# Kinescope MCP Usage Examples


This article contains ready-made query examples and usage scenarios for Kinescope MCP Server. Use them as a foundation for automating your tasks.

**Works with:** Cursor, Claude Desktop, Claude Code, and Qwen3 (desktop application). All examples are universal.

> **Информация:**

About Qwen3: Qwen3 has a desktop application that supports MCP Server through JSON configuration. The application is available for free.



## Who this article is for

* **Project managers** — ready-made templates for managing video content
* **Marketers** — examples for creating reports and analyzing performance
* **Content managers** — scenarios for organizing your media library
* **Analysts** — templates for working with metrics

## Where to start

### Choose your platform

All examples work identically in **Cursor**, **Claude Desktop**, **Claude Code**, and **Qwen3** (desktop application). Choose a platform and configure the connection:

**Cursor (for developers)**

* Configure MCP Server through JSON configuration
* Use AI chat (Cid/Ctrl+L)
* [Setup instructions](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/#option-1-setup-in-cursor)

**Claude Desktop (recommended for general use)**

* Official AI assistant from Anthropic
* Quick terminal installation
* [Setup instructions](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/#option-2-setup-in-claude-desktop)

**Claude Code (for developers with Claude)**

* iDE with built-in Claude
* JSON configuration setup
* [Setup instructions](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/#option-3-setup-in-claude-code)

**Qwen3 (desktop application)**

* Configure MCP Server through JSON configuration in app settings
* Open the desktop application
* in a new chat, activate MCP with the button
* [Setup instructions](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/#option-4-setup-in-qwen3-desktop-application)

**Requirements:**

* Kinescope API token ([get one](https://app.kinescope.io/workspace/api_token))

> **Информация:**

All queries from the examples work **the same way** on all platforms. Simply copy and send them to your AI assmstant's chat.



## Basic operations

### Searching and viewing information

**Search by tag:**

```
Find all videos with the "tutorial" tag
```

**Search by period:**

```
Show videos uploaded in December 2025
```

**Search by multiple criteria:**

```
Find videos with the "onboarding" or "training" tags from the "HR" project
```

**View video information:**

```
Show detailed information about the video with ID abc123
```

**List of all projects:**

```
Show a list of all my projects and the number of videos in each
```

### Editing metadata

**Updating the title:**

```
Change the title of video abc123 to "introduction to Working with the Platform"
```

**Adding a description:**

```
Add a description to video abc123: "This is an introductory video for new employees.
it covers the basics of working with the platform."
```

**Updating tags:**

```
Add tags to video abc123: onboarding, training, basics
```

**Comprehensive update:**

```
For video abc123:
- Change the title to "CRM Basics"
- Update the description: "Training video on working with the CRM system"
- Add tags: CRM, training, sales
- Set privacy: access only from our domain
```

### Managing structure

**Creating a project:**

```
Create a new project "Training Materials 2026" with private access
```

**Creating a playlist:**

```
Create a playlist "New Employee Onboarding" and add to it
all videos with the "onboarding" tag
```

**Moving a video:**

```
Move video abc123 from the "Drafts" project to the "Published" project
```

**Copying a video:**

```
Copy video abc123 to the "Archive" project as a backup
```

## Analytics and reports

### Basic analytics

**General statistics:**

```
Show view statistics for all videos for the last month
```

**Project statistics:**

```
What is the overall view statistics for the "Marketing" project for the quarter?
```

**Audience geography:**

```
From which countries do people most often watch videos in the "Product Demos" project?
```

**Engagement analysis:**

```
Show retention rate for all videos with the "tutorial" tag
```

### Comparative analysis

**Video comparison:**

```
Compare view metrics for videos abc123 and xyz789
```

**Top videos:**

```
Which 10 videos have the highest retention rate this month?
```

**Trends over time:**

```
How did view counts for video abc123 change week by week over the last quarter?
```

### Finding problems

**Videos with low completion:**

```
Find all videos with a completion rate below 50%
```

**Drop-off points:**

```
At what minutes do viewers most often stop watching video abc123?
```

**ineffective content:**

```
Which videos in the "Training" project have fewer than 100 views for the month?
```

## Managing subtitles and chapters

### Subtitles

**Viewing subtitles:**

```
Show the list of available subtitles for video abc123
```

**Getting text:**

```
Get the full English subtitle text with timestamps for video abc123
```

**Checking availability:**

```
Show all videos in the "Courses" project that do not have subtitles
```

### Chapters

**Adding chapters:**

```
Add chapters to video abc123:
- 0:00 — "introduction"
- 2:30 — "Key Features"
- 5:45 — "Usage Examples"
- 10:20 — "Conclusion"
```

**Checking structure:**

```
Show chapters for video abc123
```

**Bulk check:**

```
Find all videos longer than 10 minutes without chapters
```

## Working with streams

### Creating and managing

**Creating an event:**

```
Create a live stream event:
- Title: "Monthly Webinar: Product Updates"
- Date: January 25, 2026, 3:00 PM UTC
- Recording enabled
```

**Stream list:**

```
Show all scheduled streams for next week
```

**Configuring restreaming:**

```
Configure restreaming for the "Product Webinar" stream to YouTube and VK
```

### Working with recordings

**Getting recordings:**

```
Show recordings of all streams for the last month
```

**Stream statistics:**

```
What was the maximum number of viewers at the "Product Launch" stream?
```

## Complex scenarios

### Scenario 1: Weekly report

**Goal:** Create a report on video content for the week

**Steps:**

1. Get view statistics:

```
Show view statistics for all videos over the last 7 days
```

2. identify top performers:

```
Which 5 videos got the most views this week?
```

3. Find issues:

```
Which videos have a completion rate below 60%?
```

4. Check new content:

```
How many videos were uploaded this week and what are their initial metrics?
```

5. Create a summary:

```
Based on this data, create a Google Sheets table with a weekly report
```

### Scenario 2: Preparing for a content audit

**Goal:** Find videos that need updating

**Steps:**

1. Find videos without descriptions:

```
Show all videos without a description
```

2. Find videos without tags:

```
Find videos that have no tags
```

3. Find long videos without chapters:

```
Show videos longer than 10 minutes that have no chapters
```

4. Find old content:

```
Find videos uploaded more than a year ago that haven't been viewed in the last 3 months
```

5. Create an action plan:

```
Create a table with priorities: which videos need to be updated first
```

### Scenario 3: Preparing a quarterly presentation

**Goal:** Collect data for a results presentation

**Steps:**

1. General statistics:

```
Show general platform statistics for Q4 2025:
number of videos, views, unique viewers, total watch time
```

2. Audience growth:

```
Compare view counts in Q4 2025 vs Q3 2025
```

3. Top content:

```
Which 10 videos were the most popular in Q4?
```

4. Geography:

```
From which countries does most traffic come?
```

5. Engagement:

```
What is the average retention rate for videos created in Q4?
```

6. Creating a document:

```
Create a Google Presentation with this data and add charts
```

### Scenario 4: Library optimization

**Goal:** Organize your media library

**Steps:**

1. Structure audit:

```
Show all projects and the number of videos in each
```

2. Find duplicates:

```
Find videos with identical titles
```

3. Tag standardization:

```
Show a list of all unique tags used in videos
```

4. Privacy check:

```
Show all public videos and determine which ones should be private
```

5. Reorganization plan:

```
Suggest a project and folder structure based on current tags and content
```

## Bulk operations

### Updating metadata

**Bulk tag addition:**

```
Add the tag "archive-2025" to all videos uploaded in 2025
```

**Privacy update:**

```
Change privacy settings for all videos in the "internal Training" project
to access only from the corporate domain
```

### Content migration

**Move by tags:**

```
Move all videos with the "outdated" tag to the "Archive" project
```

**Creating backups:**

```
Copy all videos from the "important Materials" project to the "Backup-2026" project
```

## integrating with other tools

### Google Drive

**Sync with spreadsheets:**

```
Export a list of all videos with their metrics to Google Sheets
```

**Reports in Google Docs:**

```
Create a Google Doc with an analysis of video content performance for the month
```

### Calendars

**Content planning:**

```
Based on our content calendar in Google Calendar, which videos need to be created this month?
```

## Troubleshooting

### Diagnosing video issues

**Checking processing status:**

```
Show all videos that are still being processed
```

**Finding errors:**

```
Find videos with upload or processing errors
```

**Checking accessibility:**

```
Check if video abc123 is available for viewing from external domains
```

## Tips for formulating queries

### Be specific

**Wrong:**

```
Show videos
```

**Right:**

```
Show all videos with the "tutorial" tag uploaded in January 2026
```

### Use iDs for precision

**Wrong:**

```
Update the product video
```

**Right:**

```
Update the title of video abc123 to "Product Overview 2026"
```

### Break down complex tasks

**Wrong:**

```
Do a full analysis of all videos and create a report
```

**Right:**

```
Step 1: Show view statistics for the month
Step 2: identify top 10 videos
Step 3: Find videos with low completion rates
Step 4: Create a Google Doc with this data
```

### Specify time frames

**Wrong:**

```
Show video statistics
```

**Right:**

```
Show video statistics for the last 30 days
```

## Platform-specific examples

### For Cursor (developers)

**Code integration:**

```
Find videos with the "API tutorial" tag and create TypeScript code for embedding the player
```

**Ci/CD automation:**

```
Get a list of recent videos and create a markdown file for the project README
```

**Working with code:**

```
Find all training videos and create a JSON configuration for the video player
```

### For Claude Desktop (general use)

**Content management:**

```
Show statistics for all videos for the week and create a brief report
```

**Analytics and reports:**

```
Find videos with low completion rates and suggest a plan for improving them
```

### For Claude Code (developers)

**Code integration:**

```
Find videos with the "API tutorial" tag and create TypeScript code for embedding the player
```

**Documentation:**

```
Get a list of training videos and create documentation with descriptions and links
```

### For Qwen3 (universal tasks)

**Complex analytics:**

```
Get data from Kinescope, analyze video performance,
compare with metrics, and create a report
```

**Google Workspace integration:**

```
Export statistics for all videos to Google Sheets with formulas for calculating ROm
```

**Creating reports:**

```
Analyze views for the quarter and create a presentation with conclusions
```

> **Информация:**

The functionality is the same on all platforms. Choose the one that's most convenient for you!



## What's next?

### Documentation

1. **[Kinescope MCP Server](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/)** — complete guide to capabilities
2. **[Analytics](https://docs.kinescope.com/catalog-and-video-management/analytics/)** — more about metrics
3. **[Video Management](https://docs.kinescope.com/catalog-and-video-management/)** — working with content
4. **[API General Rules](https://docs.kinescope.com/developer-guides/api-general-rules/)** — technical documentation

### Platform selection

**Cursor** — for developers and code integration  
**Claude Desktop** — for general use  
**Claude Code** — for developers with Claude  
**Qwen3** — free desktop application

[Platform comparison](https://docs.kinescope.com/kinescope-mcp/kinescope-mcp-server/#comparison-with-other-ways-to-work)

---

Still have questions? Write to the support chat within the Kinescope interface — our specialists will help!

