# Brandfolder MCP for AI Agents MCP

> Brandfolder lets your AI agent manage entire digital asset libraries without opening a browser. Search for specific logos, retrieve metadata, map collections, or even delete old assets—all from a natural conversation with Claude or Cursor.

## Overview
- **Category:** design-creative
- **Price:** Free
- **Tags:** digital-asset-management, brand-logistics, visual-content, asset-discovery, media-library, enterprise-branding

## Description

Dealing with brand guidelines used to mean navigating endless folder trees and hoping you found the right version of a logo. Now, your agent handles it. Connect Brandfolder via Vinkius, and you can talk to your AI client about your entire digital asset repository like it's just another conversation.

You tell the agent what you need—say, 'the primary vector for Q3 marketing assets.' It searches across all your defined organizations and collections, pulls up the exact file, and gives you a direct link. You don’t have to click through five different dashboards or guess which folder has the final version.

Beyond searching, you can ask it to check specific asset metadata, see what tags are applied, or even tell it to create a brand-new document in the system for your team's use. It takes the complexity out of enterprise branding so you can focus on the creative work itself.

## Tools

### create_cms_asset
Adds a new digital asset, like an image or document, into your Brandfolder system.

### wipe_media_asset
Permanently removes a digital asset from Brandfolder.

### get_asset_details
Retrieves comprehensive metadata for any specific digital asset you name.

### get_brandfolder_assets
Searches and pulls back digital assets from a specified Brandfolder location.

### get_collection_assets
Finds and retrieves all digital assets stored within a specific organized collection.

### list_asset_attachments
Returns the actual CDN delivery URLs for an asset, including any attached files.

### list_asset_tags
Verifies and lists all structural tags attached to a digital asset.

### list_global_brandfolders
Pulls a list of every Brandfolder (logical container) available across your workspace.

### list_platform_organizations
Retrieves all top-level corporate organizations accessible by your API key.

### patch_cms_asset
Updates the metadata attributes on an already existing digital asset.

## Prompt Examples

**Prompt:** 
```
Show me all high-res assets tagged for 'Q4 Campaign' across my main marketing organization.
```

**Response:** 
```
**🎯 Q4 Campaign Assets Found:**

*   **Logo Set (Primary):** `assets/q4/logo_primary.svg` 
    *   *Tags:* Q4, Brand Guideline 2025, Vector.
    *   *Owner:* Marketing Team.
    *   *Status:* Approved.

*   **Hero Image:** `assets/q4/hero_banner.jpg`
    *   *Size:* 1920x1080px. CDN Link: [Link]
    *   *Usage:* Web Only.
```

**Prompt:** 
```
I need to check the metadata for 'pitch deck template v3'.
```

**Response:** 
```
**📄 Asset Details: Pitch Deck Template V3**

| Field | Value |
| :--- | :--- |
| **Asset ID** | 78b2-c4d1 |
| **Version** | 3.0 (Final) |
| **Format** | PPTX/Vector Source |
| **Attached Files** | CDN Link for Fonts, CDN Link for Icons |
| **Tags** | Sales Enablement, Q3, Template |

*Note: This asset is owned by the Sales Department.*
```

**Prompt:** 
```
List all available collections that are active right now.
```

**Response:** 
```
I found 4 active collections under your primary organization:

1.  **Q3 Marketing Assets:** (Contains current campaign logos and photography.)
2.  **Social Media Vectors:** (High-res, optimized graphics for Instagram/Twitter.)
3.  **Annual Reports:** (Official yearly documents and brand guides.)
4.  **Legal Templates:** (Approved legal boilerplate and contract assets.)
```

## Capabilities

### Search and Discover:
Find assets across all Brandfolders, collections, or specific organizations.

### Inspect Metadata & Links:
Pull detailed metadata, including CDN delivery URLs and structural tags.

### Modify Content Lifecycle:
Create new assets, update existing records, or permanently delete files programmatically.

## Use Cases

### Finding a specific logo variant
A designer needs the 400x400 blue PNG of the Q3 campaign logo. They ask their agent to search assets by tag and collection. The agent uses `get_collection_assets` and confirms the correct file, providing an immediate download link.

### Verifying corporate structure
A new user needs to know which departments have access to brand guidelines. They ask their agent to list all available organizations. The agent uses `list_platform_organizations` and provides a clear map of top-level tenants.

### Updating an outdated asset
The legal team updated the corporate boilerplate text on a pitch deck template. Instead of manually replacing it, they ask their agent to update the existing record using `patch_cms_asset` with the new metadata.

### Cleaning up old content
A manager needs to remove several expired assets from a collection. They prompt the agent, which then uses `wipe_media_asset` on each file, ensuring they are permanently deleted and removed from circulation.

## Benefits

- Find the correct file instantly. Instead of browsing folders, you ask your agent to use `get_brandfolder_assets` or `get_collection_assets`, pulling up only what matches your search criteria.
- Never deal with version confusion again. Use `get_asset_details` to pull all metadata and check the asset's history right in the chat, guaranteeing you have the approved file.
- Streamline governance. Your agent can use `list_platform_organizations` and `list_global_brandfolders` to understand your entire company structure before finding anything.
- Control the content lifecycle. You can initiate changes by using `create_cms_asset` or update existing records with `patch_cms_asset`, all through conversational commands.
- Get direct delivery links. The tool doesn't just find the file; it uses `list_asset_attachments` to serve you the actual CDN-backed URL, ready for use.

## How It Works

The bottom line is, you get instant access to complex brand data and functionality through simple chat prompts.

1. You connect this MCP to your preferred AI client via Vinkius and authorize it using your personal Brandfolder API Token.
2. You prompt the agent with a natural language request, such as 'Find all high-res vectors for the new campaign.'
3. The agent uses the necessary tools to query Brandfolder's database, retrieving specific asset links, metadata, or even generating new assets.

## Frequently Asked Questions

**How can Brandfolder MCP help me find the latest logo version?**
The system finds the correct file by searching across all collections and organizations, ensuring you pull the most recent approved asset. It checks metadata so you know exactly if it's current.

**Does Brandfolder MCP let me manage assets without using a browser?**
Yes, you interact with your digital asset library entirely through chat. You can ask the agent to retrieve links, check details, or even create new files, eliminating manual clicking.

**Can I update metadata on existing assets using Brandfolder MCP?**
Absolutely. The agent allows you to programmatically edit an asset's attributes, like adding a new tag or changing the owner, without needing special backend access.

**What if I need to remove old brand guidelines from circulation?**
The MCP includes tools that let you permanently delete assets. You can instruct your agent to wipe media files, ensuring they are removed completely and cannot be rediscovered.

**Does Brandfolder MCP understand my company's different departments?**
Yes. It maps your entire corporate structure by listing global brandfolders and platform organizations, giving you visibility into every container of assets across the whole enterprise.