# 4YouSee MCP

> 4YouSee MCP: This tool connects your AI agent directly to a digital signage management system. It lets you audit complex content networks, check player connectivity status across thousands of screens, and inventory media assets—all through natural conversation. You get real-time operational visibility without ever touching a dashboard.

## Overview
- **Category:** content-management
- **Price:** Free
- **Tags:** digital-signage, media-management, network-monitoring, content-delivery, display-management, retail-tech

## Description

Managing a large network of signs is usually a manual nightmare. If a screen goes offline or if the wrong version of a campaign ad gets pushed out, you don't know until someone notices. This MCP lets your agent act like an on-call operations manager for your entire digital signage setup. You can ask it to check connectivity and immediately find any players that are reporting issues; it doesn't just give you a list—it gives you the operational status. Need to verify if a new news template is ready? The agent checks the library metadata instantly, so you don't waste time sifting through file paths. It pulls everything together into a simple chat response. Since Vinkius hosts this MCP, your AI client accesses all the necessary tools in one place, giving you complete control over both content and hardware status.

## Tools

### list_players
Returns a list of all players registered to the network, regardless of their current status.

### get_player
Gets deep status information for one specific digital signage player unit.

### list_medias
Lists every single media file available in the content library, like videos and images.

### list_templates
Retrieves metadata and details for available content layouts and news templates.

### list_users
Provides a list of authorized platform users and the groups they belong to.

## Prompt Examples

**Prompt:** 
```
Show me all offline players in my 4YouSee network.
```

**Response:** 
```
I've scanned your network and identified 3 offline players. Here are their names and locations so you can take action.
```

**Prompt:** 
```
List all uploaded video files in my 4YouSee media library.
```

**Response:** 
```
I've retrieved your media library. You have 12 video files currently available, including 'promo_winter.mp4' and 'brand_loop.mov'. Would you like the full IDs for any of them?
```

**Prompt:** 
```
Which dynamic templates are available for my signage network?
```

**Response:** 
```
I've found 5 active templates in your 4YouSee Manager, including news layouts and weather widgets. I can provide the names and configuration details for each.
```

## Capabilities

### Audit Network Status
List every player connected to the network and determine their current online health.

### Diagnose Specific Player Issues
Retrieve detailed, technical monitoring data for one particular signage player.

### Inventory Campaign Assets
List every available media file (videos, images) stored in the content library.

### Manage Content Layouts
View and audit the metadata for news feeds and dynamic content templates used across signs.

### Verify System Permissions
List authorized users and groups to confirm who has access to platform controls.

## Use Cases

### The Q3 Campaign Launch
Marketing needs to launch 50 new ads across 10 locations. Instead of checking each location's dashboard, the agent runs `list_players` to confirm all units are online and then uses `list_medias` to verify that every single asset is uploaded and ready for deployment.

### The Emergency Downtime Fix
A store reports a blank screen. The Ops Engineer asks the agent to run `get_player` on the specific unit ID. The agent returns detailed status metrics, telling the engineer whether it's a network issue or a media file problem.

### Compliance Audit
The IT team needs proof of who has access to publish content. They use `list_users` to get an accurate list of all authorized accounts and the groups associated with them for compliance reporting.

### Template Refresh Cycle
A Content Curator wants to update the corporate news feed layout. The agent uses `list_templates` to see what types of layouts are available, ensuring they pick a structure that matches the new content requirements.

## Benefits

- Instantly find network failures. Instead of manually logging into a dashboard, simply ask the agent to list all players and get an immediate breakdown of offline units.
- Audit content flow with precision. You can check templates using `list_templates` to confirm news layouts are configured correctly before launch, preventing bad campaigns from going live.
- Never lose track of assets again. Use `list_medias` to generate a full inventory of every video or image file available for display, simplifying content audits.
- Rapid hardware diagnostics. If an error pops up, use `get_player` to pull specific technical health details on the unit ID, saving time usually spent debugging connection logs.
- Maintain clean governance. Need to know who can publish content? Running `list_users` gives you a clear list of accounts and their permissions structure.

## How It Works

The bottom line is, you talk to it naturally, and it executes complex network audits via its connected tools.

1. Subscribe to the 4YouSee MCP on Vinkius.
2. Provide your unique 4YouSee Manager Secret Token to authenticate the connection.
3. Ask your AI client a question like, 'Show me all offline players,' and get an immediate status report.

## Frequently Asked Questions

**How do I find all my connected signage players using the 4YouSee MCP?**
Run `list_players` to get a master list of every unit ID on your network. This is always the starting point for any status check.

**What does 'auditing content' mean with `list_templates`?**
`list_templates` lets you see the available design layouts and their metadata. It confirms that your content isn't just uploaded, but also configured to display correctly.

**Can I check if a specific player is online using `get_player`?**
Yes. You must provide the exact player ID when calling `get_player`. This tool gives you deep technical diagnostics, confirming real-time status and health details.

**How can I see if new ads are ready to go live? (list_medias)**
Use `list_medias` to get a complete inventory of your content library. It shows you all available files, helping you confirm the ad assets are uploaded.

**How do I audit which platform users are authorized to manage content using `list_users`?**
The tool lists all active platform users and defined groups. You can use this data point to confirm organizational roles and maintain strict access control across your entire signage network.

**When I run `list_templates`, what specific metadata about the layout structure do I get?**
The tool shows both news templates and dynamic content layouts. You'll receive key configuration details, including necessary metadata to ensure consistent design standards across all displays.

**Can I filter the list of devices using `list_players` by status or physical location?**
Yes, you can refine the player list based on criteria like current operational status or geographical zone. This helps you pinpoint specific groups needing immediate attention across large-scale installations.

**If a player is showing errors, what detailed technical data do I get using `get_player`?**
The tool returns deep monitoring metrics that go beyond simple online status. You'll get vital information regarding the player's connectivity health and specific error codes for fast troubleshooting.

**How do I check if a player is offline?**
Use the `list_players` tool. It will return a list of all players including their current status (online/offline) and last seen timestamp.

**Can I see which media files are available for broadcast?**
Yes. Use the `list_medias` tool to retrieve your library, including filenames, IDs, and file types. This is perfect for auditing your content before scheduling.

**Is it possible to manage users via the agent?**
You can list existing users and groups using the `list_users` tool to audit permissions and access, but creating or deleting users must be done in the 4YouSee Manager.