# PeerTube MCP for AI Agents AI Agent Connect

> PeerTube (YouTube Alternative) MCP lets your AI client navigate decentralized video feeds, grab download links, and manage user accounts on your PeerTube instance. It turns your AI into a power user for the Fediverse's leading video platform, handling everything from monitoring transcoding jobs to fetching private web videos.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LKQLLqLP54nVwlyNq5CNX9Ld0HBccJT0zgxpFkMs/ai-agent-connect
- **Tags:** decentralized, fediverse, video-hosting, rss-feeds, content-discovery, open-source

## Description

Stop jumping between tabs to check your video status or hunt for specific content across different instances. This Connector lets you treat your PeerTube instance like a direct data source for your AI client. Instead of manually digging through RSS feeds or hunting for OAuth credentials, you can just ask your agent to find what you need. If you're running an instance, you can monitor background jobs and manage user registrations without ever touching a terminal or a complex dashboard. It's a way to bring the decentralized video world into your daily workflow without the friction of manual API calls or complex web navigation. You'll find it's a lot easier to manage your feeds and content when your AI can just go get it for you. Vinkius makes it easy to plug this directly into your existing setup so you can start querying videos, pulling playlists, and managing your instance immediately. It handles the heavy lifting of interacting with the Fediverse's video platform, giving you a clean way to stay on top of your content production and community engagement.

## Tools

### get_video_comments_feed
Pull the latest comments from a video's comment section. This helps you keep up with community discussions easily.

### get_video_feeds
Retrieve various video feeds in formats like RSS or JSON. Use this to pull content from different instances quickly.

### get_public_hls_playlist
Retrieve a public HLS playlist file for a specific video. Use this for consistent streaming of your content.

### get_public_web_video
Get a public web video file directly from the platform. This simplifies finding and accessing public content.

### get_user_token
Fetch a user access token for authenticated actions. Use this to let your agent perform actions on your behalf.

### generate_video_download
Create a direct download link for a specific video file. This lets you save content for offline viewing without extra steps.

### get_completed_jobs
View a list of finished background processing jobs on your instance. Use this to see which videos are ready for the public.

### get_local_oauth_clients
Pull local OAuth client credentials for connecting other apps. This makes it easy to manage third-party integrations.

### get_private_web_video
Fetch a private web video file when you have the correct token. This is useful for accessing restricted content securely.

### register_user
Create a new user account on your PeerTube instance. This lets you manage new members without manual entry.

## Prompt Examples

**Prompt:** 
```
Can you check if my last video has finished transcoding?
```

**Response:** 
```
Checking your PeerTube instance... I've looked at the background jobs. Your video **Summer_Vlog_01** finished processing 2 minutes ago. Would you like me to check the next one?
```

**Prompt:** 
```
Get me the latest comments for video ID 12345 in a list.
```

**Response:** 
```
Fetching the comments... Here are the latest 5 comments for that video:

* **@User1**: Great video!
* **@User2**: Love the editing.
* **@User3**: Where can I find more?
* **@User4**: Amazing content.
```

**Prompt:** 
```
I need to register a new user on my instance. Can you do that?
```

**Response:** 
```
I can help with that. Please provide the **username** and **email** you'd like to use for the new PeerTube account, and I'll get that registered for you.
```

## Capabilities

### Fetch video download links
Get direct links for offline viewing of specific videos.

### Track transcoding progress
Check the status of background video processing jobs.

### Manage user registrations
Create new accounts on your PeerTube instance via the AI.

### Retrieve private content
Access private web videos using the necessary tokens.

### Fetch comment feeds
Pull recent discussions from video comment sections.

### Get HLS playlists
Retrieve public HLS playlist files for streaming.

### Manage OAuth clients
Access local credentials for third-party app connections.

## Use Cases

### Checking video status
A creator asks the agent if their last upload is done. The agent uses get_completed_jobs to check the status instantly.

### Managing credentials
A developer needs to connect a new app. They ask the agent to get_local_oauth_clients to see the keys without opening a terminal.

### Content gathering
A researcher wants to see the latest comments. They ask the agent to pull the get_video_comments_feed in JSON format.

### Account setup
A new user wants to join an instance. The creator asks the agent to register_user to get them started quickly.

## Benefits

- Skip the manual terminal work by using register_user to create accounts or get_local_oauth_clients to manage credentials.
- Monitor your content production in real-time with get_completed_jobs to see which videos are ready for the public.
- Simplify content discovery by letting your agent pull video_feeds in RSS or JSON formats automatically.
- Get offline access to your favorite content by using generate_video_download to grab direct links.
- Manage private content more easily by using get_private_web_video with your existing tokens.
- Keep up with your community by using get_video_comments_feed to pull recent discussions into your workspace.

## How It Works

The bottom line is you get a direct line of communication between your AI and your PeerTube instance.

1. Subscribe to this Connector on Vinkius.
2. Provide your PeerTube Instance URL and your Personal Access Token.
3. Ask your AI client to find videos, check jobs, or manage your account.

## Frequently Asked Questions

**What is the PeerTube MCP for AI Agents?**
This Connector lets your AI client interact directly with PeerTube instances. You can use it to manage your video feeds, check transcoding jobs, and handle user registrations through a simple chat interface.

**Can I use this to manage my own PeerTube instance?**
Yes. If you run your own PeerTube instance, this Connector gives your AI agent the ability to perform administrative tasks like managing OAuth clients and monitoring background jobs.

**How do I get download links for videos?**
You can simply ask your AI client to generate a download link for a specific video. It will fetch the direct link from your PeerTube instance for you.

**Can this Connector handle private videos?**
Yes, it can retrieve private web videos as long as you provide the necessary video file tokens for the AI to access the content.

**Will this work with my existing PeerTube account?**
It will work with your account as long as you provide your PeerTube Instance URL and your Personal Access Token to the Connector during setup.

**Can I use this to monitor my video uploads?**
Absolutely. You can ask your agent to check the status of your transcoding jobs to see if your videos are ready for the public.

**Does the PeerTube MCP support different feed formats?**
Yes, it can retrieve video feeds in several common formats, including RSS, Atom, JSON, and XML, making it easy for your agent to parse the data.

**How can I generate a direct download link for a PeerTube video?**
You can use the `generate_video_download` tool by providing the video's ID or UUID. The agent will return a muxed mp4 container link for downloading.

**Can I register a new user account on my instance using the AI?**
Yes, if the instance allows public registration, you can use the `register_user` tool with a username, password, and email address.

**How do I check if my video transcoding jobs are finished?**
Use the `get_completed_jobs` tool. It retrieves a list of all finished background jobs, allowing you to verify successful processing.