# Widen (Acquia DAM) MCP MCP

> Widen (Acquia DAM) MCP lets you search, audit, and manage your entire library of branded media assets conversationally. Instead of manually clicking through folders or remembering complex internal syntax, ask your AI agent to find a file by metadata, pull the necessary CDN link for web use, or even clean up obsolete content—all in one chat session.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** digital-asset-management, metadata-management, cdn, enterprise-content, file-storage, asset-library

## Description

Your brand assets are scattered across massive digital libraries. Finding the right logo version or the correct photo requires knowing specific folder paths and complex search queries. This MCP lets your AI agent handle that complexity. You talk to it like a person, telling it exactly what you need—whether that's listing every user with access or pulling the active embed links for a product shot.

The power comes from connecting these disparate functions: find an asset using internal criteria, then ask for its technical properties, and finally grab the CDN link. When you build complex automation chains across multiple MCPs via Vinkius, you can track every single step in detail using Vinkius AI Analytics. Nothing happens in a black box; you always know which assets were checked and how your budget is being used.

This means content creators can update asset metadata on the fly, marketing teams get instant links for web deployment, and administrators can safely audit user access or delete media they no longer need.

## Tools

### delete_media_asset
Permanently removes a specific asset from the DAM instance, making it unusable.

### get_asset_details
Retrieves all technical properties and metadata for one particular asset ID.

### get_category_contents
Shows you every asset and sub-folder inside a specified top-level category.

### list_account_users
Lists every authorized user account within the Widen DAM instance.

### list_cdn_embed_links
Gathers all active CDN links and HTML snippets for a given asset ID.

### list_collection_assets
Lists every file contained within a specific user-defined asset collection.

### list_global_categories
Retrieves the names of all top-level folders (categories) in the DAM hierarchy.

### list_saved_collections
Lists the names of all custom collections users have created.

### search_widen_assets
Searches for assets using Widen's internal search syntax across the entire library.

### update_asset_metadata
Changes or adds metadata fields to an existing asset ID.

## Prompt Examples

**Prompt:** 
```
Search for assets with 'marketing' in the category and 'banner' in the filename.
```

**Response:** 
```
I found 3 assets matching your query: 1. 'summer_banner_v1.jpg' (ID: wid-101), 2. 'winter_sale_banner.png' (ID: wid-102), and 3. 'logo_banner_final.ai' (ID: wid-103). Would you like to see the details or embed links for any of these?
```

**Prompt:** 
```
Get the CDN embed links for asset ID 'wid-101'.
```

**Response:** 
```
Here are the active CDN links for asset wid-101: 1. Public Image URL: https://embed.widen.net/img/..., 2. Responsive Snippet: <img src='...' />, 3. Original File: https://embed.widen.net/file/... Would you like the HTML code for a specific size?
```

**Prompt:** 
```
List all global categories in our Widen DAM.
```

**Response:** 
```
I found 5 top-level categories: 'Brand Guidelines', 'Product Photos', 'Marketing Campaigns', 'Internal Documentation', and 'Legacy Archive'. Which category would you like to explore?
```

## Capabilities

### Search by Internal Criteria
Find specific assets using Widen's proprietary search syntax across millions of files.

### Retrieve Technical Details
Get the full metadata and technical properties for any single asset, like resolution or file type.

### Generate Web Embed Codes
Pull active CDN links and HTML snippets needed to display an image on a website.

### Map Asset Collections
List all user-defined groupings of assets or browse the top-level folder structure.

### Manage User Access
Check which accounts are authorized within the DAM and what roles they hold.

### Clean Up Assets
Permanently remove obsolete media files to keep your storage clean.

## Use Cases

### The Campaign Launch Check
A marketer needs the logo and product shot for a new ad. Instead of asking three different people, they ask their agent: 'Find all assets in the 'Q4 Product' category that contain 'logo' AND have CDN embed links.' The agent runs `get_category_contents` then `list_cdn_embed_links`, giving them everything needed to launch.

### The Cleanup Audit
A DAM admin realizes the 'Legacy Archive' folder is full of unused assets. They ask their agent to list all saved collections and then use `list_collection_assets` on each one, allowing them to systematically flag files for deletion using `delete_media_asset`.

### The Metadata Update
A content team just finished a photoshoot. They ask their agent: 'Update the metadata for all assets in Collection X with the tag 'Spring 2025' and set the creator to Jane Doe.' The agent executes `update_asset_metadata` across the board.

### The User Access Review
An ops engineer needs to verify who has permission to view sensitive product images. They simply ask their agent, and it runs `list_account_users`, providing a clear roster of all authorized team members.

## Benefits

- Stop guessing how to find a file. Use `search_widen_assets` to locate assets instantly, even if you only know keywords or categories.
- No need to copy and paste links. Using `list_cdn_embed_links` pulls all active web embed codes right into your chat window for immediate deployment.
- Keep your data clean and compliant by running `delete_media_asset` on obsolete assets, managing storage without manual file handling.
- Verify permissions instantly. Running `list_account_users` gives you a full audit of who can access which parts of the DAM.
- Never lose track of files again. You can view all contents within a folder using `get_category_contents`, or check grouped assets with `list_collection_assets`.

## How It Works

The bottom line is: You manage massive digital libraries through simple chat commands instead of clicking through complex web interfaces.

1. First, subscribe to this MCP and enter your Widen Access Token.
2. Next, connect it to your preferred AI agent (like Claude or Cursor).
3. Finally, tell your agent what you need—for example, 'Find all assets tagged with Q3 2024'—and the tool executes the request.

## Frequently Asked Questions

**How do I find a file using the search_widen_assets tool?**
You provide a query string that uses Widen's internal syntax, specifying criteria like category or filename within your prompt. The agent handles the complex query structure for you.

**Can list_cdn_embed_links get me an image link for my website?**
Yes. This tool pulls all active CDN links and HTML snippets (like `<img src='...'/>`) ready to drop directly into your web code.

**Does this MCP help with user permissions? Use list_account_users.**
It lists every authorized account in the DAM instance. This helps you audit who has access and ensures only appropriate teams can view sensitive content.

**What if I want to delete old assets? Should I use delete_media_asset?**
Yes, `delete_media_asset` permanently removes an asset from the DAM. Remember this is irreversible; always confirm before running it.

**When I use `update_asset_metadata`, what format must the metadata payload follow?**
The tool requires a structured JSON object that maps field keys directly to their new values. You specify exactly which fields you want to change and what their updated data should be.

**How do I see all the main folder categories in my DAM using `list_global_categories`?**
This tool immediately lists every top-level category available across your entire DAM hierarchy. It gives you a complete map of where assets are organized, letting you know exactly where to start browsing.

**Beyond just the file name, what technical data does `get_asset_details` provide?**
It retrieves comprehensive metadata and deep technical properties for any single asset ID. You get a full record, including creation dates, dimensions, and all associated system tags.

**If I need to view every file inside a specific user-curated group, should I use `list_collection_assets`?**
Yes. This tool lists every single asset contained within that specific user collection ID. It's the definitive way to see everything curated and grouped together by a team member.