# MediaSilo MCP

> MediaSilo MCP Server connects your AI client directly to MediaSilo's asset library. You manage complex media assets, track project metadata, and organize entire content workflows using simple conversation prompts. Stop clicking through UIs; start asking for files, project lists, or user details instantly.

## Overview
- **Category:** content-management
- **Price:** Free
- **Tags:** digital-asset-management, video-collaboration, media-workflow, file-sharing, project-management

## Description

**MediaSilo MCP Server** connects your AI client directly to MediaSilo's entire asset library and project backend. Forget clicking through endless menus; you just tell your agent what you need, and it pulls structured data straight from MediaSilo. You manage everything—from finding a specific video file buried deep in a folder structure to tracking who has access to shared assets. This isn't another dashboard; it's instant command access.

### Asset Discovery and Detail Retrieval
When you need media files, the server gives you three ways to find 'em. If you want everything on record, run `list_assets` to pull a comprehensive list of every asset in your account. Need something specific? Use `search_assets` to filter that massive library using keywords or filters across all content. Once you narrow it down and get an ID, you can use `get_asset` to fetch the full metadata for just that single item—you'll see dimensions, file type, and who owns it.

### Project Mapping and Content Auditing
To understand your project scope, you first run `list_projects`. That gives you a roster of every active campaign or job in your workspace. From there, you can use `get_project` to retrieve the core details for any one project listed. If you need to know what assets belong to that specific project, call `get_project_assets`, which lists all associated media files linked to that ID. You can map out the internal organization by calling `list_folders`, which shows you the folder directory structure *inside* a given project. This process lets your agent build out a complete content audit trail for any campaign.

### User and Sharing Management
For team collaboration, you've got tools to manage people and links. You can run `list_users` to get a list of every authorized user in the MediaSilo workspace, giving you an immediate view of who has access. If you need details on shared content, you can use `list_quicklinks` to pull up a manifest of all generated secure media links managed by your account. To check the status or specific details of one link, just pass it through `get_quicklink`. This means your AI client handles everything from checking user permissions and listing assets to mapping out entire project structures—all without you ever touching a UI.

## Tools

### get_asset
Fetches detailed metadata for one specific media asset by its ID.

### get_project
Retrieves the core details of a single, defined project.

### get_project_assets
Lists all media assets associated with a specific project ID.

### get_quicklink
Gets the details and status of one secure shared media link (Quicklink).

### list_assets
Retrieves a comprehensive list of all assets available in your MediaSilo account.

### list_folders
Lists the folder directory structure within an active project.

### list_projects
Pulls a list of all currently active projects in your workspace.

### list_quicklinks
Lists all generated Quicklinks managed by the account.

### list_users
Provides a list of every authorized user within the MediaSilo workspace.

### search_assets
Searches the entire asset library using specific keywords or filters.

## Prompt Examples

**Prompt:** 
```
List the most recent assets in MediaSilo.
```

**Response:** 
```
Retrieving assets... I found several recently added files, including 'Commercial_V3.mp4' and 'Product_Hero_Shot.jpg'.
```

**Prompt:** 
```
Show folders for project 'Fall Campaign'.
```

**Response:** 
```
Querying project folders... The 'Fall Campaign' project contains 3 folders: 'Raw Footage', 'Drafts', and 'Approved Masters'.
```

**Prompt:** 
```
Search for assets matching 'logo'.
```

**Response:** 
```
Searching... I found 5 assets matching 'logo', including high-res PNGs and vector files.
```

## Capabilities

### Search for Assets
Find specific media files using keywords across your entire asset library.

### Retrieve Asset Metadata
Get full details—like dimensions, file type, and owner—for a single video or image.

### Map Project Structure
List all active projects and then drill down to see the folders inside them.

### Manage Shared Links
Retrieve details for specific secure media sharing links (Quicklinks).

### Audit User Access
List all authorized users in the workspace or check a user's permissions.

## Use Cases

### Locating a Specific Version of a Logo
The Creative Director needs the high-res, vector version of the 'Brand Mark' used in Q4. Instead of manually filtering through thousands of assets, they ask their agent: 'Search for Brand Mark.' The agent runs `search_assets` and returns links to all matches, letting them select the correct file.

### Checking Project Scope Before Review
A PM needs to know what materials are ready for review in the 'Product Launch' folder. They run: 'List assets for Product Launch.' The agent uses `get_project` and then calls `get_project_assets`, providing a definitive list of every file without manual navigation.

### Auditing User Permissions
The Ops Lead needs to confirm if a contractor has been removed from the system. They run 'List all users.' The agent executes `list_users`, giving them an immediate roster they can cross-reference against internal HR records.

### Validating Campaign File Structure
The Art Director wants to confirm that the 'Fall Campaign' project has its raw footage, drafts, and masters separated. They ask: 'Show folders for Fall Campaign.' The agent runs `list_folders`, verifying the required structure in one step.

## Benefits

- Find files instantly. Instead of navigating deep folder paths, run `search_assets` to pull up every asset matching a keyword like 'logo' or 'Q3 campaign'.
- Audit entire projects fast. Use `list_projects` first, then use `get_project_assets` on the resulting project ID to see everything contained in one API call.
- Control sharing links easily. Need to know if that client link is still active? Just run `get_quicklink`, and you get its status without logging into the sharing panel.
- Understand who's involved. Run `list_users` when onboarding a team member, or check user access with `list_users` before giving out credentials.
- Metadata on demand. Don't just see the file name. Use `get_asset` to pull deep metadata (like dimensions and resolution) for immediate review.

## How It Works

The bottom line is you get direct access to MediaSilo's internal structure without navigating its UI.

1. Subscribe to MediaSilo and provide your API credentials on Vinkius.
2. Your AI client executes the request (e.g., 'Show all projects').
3. The server calls MediaSilo, returns structured data (JSON/text) to your agent's chat window.

## Frequently Asked Questions

**How do I list every project using list_projects?**
Run `list_projects`. This tool pulls a complete roster of your active campaigns and projects, giving you the names and IDs needed for subsequent calls.

**What is the difference between get_asset and search_assets?**
`search_assets` finds assets based on keywords across the whole library. `get_asset` requires you to already know the unique ID of a single file to retrieve its precise metadata.

**Can I see all files in a project? Use get_project_assets.**
Yes, run `get_project_assets`. This tool links an entire asset list directly to the specified Project ID, giving you everything contained within that scope.

**How do I check user access in MediaSilo?**
Use `list_users` to get a comprehensive roster of all authorized users. This is faster than checking permissions one by one through the UI.

**How do I find out details for a specific shared link using get_quicklink?**
It returns full metadata on one Quicklink. You'll see its sharing status, expiration date, and the associated project ID. This is key for reviewing access permissions.

**What data does the get_project tool return for a given project?**
It provides high-level details about the entire project container—like its owner, creation date, and overall scope. Use this before calling list_assets to confirm you're looking at the right workspace.

**If I need to check the folder structure within a project, how does list_folders work?**
It lists all available folders tied to a specific project ID. This allows your agent to map out the directory hierarchy before attempting to fetch assets from deep within it.

**If I call list_assets many times, what should I check regarding my API usage?**
Always monitor for 429 Too Many Requests errors. This means you've hit a rate limit and need to back off or wait before querying assets again.

**How do I find my MediaSilo API Key and Secret?**
Log in to MediaSilo, go to your Profile settings, and navigate to the API Keys section to generate a new key and secret.

**What are Quicklinks?**
Quicklinks are a core MediaSilo feature used to securely share media for review without requiring the recipient to have a MediaSilo account.

**Is my media data secure?**
Absolutely. Your credentials are encrypted at rest and injected securely at runtime.