DAM Butler

DAM Butler MCP provides intent-based asset discovery by connecting ChatGPT Enterprise to Breville's Vault DAM system. It lets you describe what you want in natural language and returns precise, ready-to-use assets, streamlining workflows across branding, marketing, and communications.

How to use

You use the MCP by querying through a compatible MCP client, such as ChatGPT Enterprise, to request assets with natural language. Start with a clear use case and region, then let the system translate your request into an asset search and delivery plan. You can specify the asset type (logo, photography, marketing material, manuals), the format (PNG, SVG, CMYK), and regional constraints (AU, UK, Australia, etc.). The system handles complex steps like brand mapping, format selection, and delivery links, returning a concise set of matches with useful notes.

How to install

# Prerequisites
- Node.js (18.x or later) and npm
- Access to OpenAI API key
- Brandfolder credentials (client_id and client_secret) if you plan to use live asset downloads

# Local setup
git clone https://github.com/vnsavitri/dam-butler-mcp.git
cd dam-butler-mcp

npm install

# Create environment file with required keys
cat > .env << EOF
OPENAI_API_KEY=your_openai_api_key_here
BRANDFOLDER_CLIENT_ID=your_brandfolder_client_id_here
BRANDFOLDER_CLIENT_SECRET=your_brandfolder_client_secret_here
VAULT_BASE_URL=https://thevault.work/breville
VAULT_API_BASE=https://api.brandfolder.com/v4
BRANDFOLDER_REDIRECT_URI=https://dam-butler-mcp.vercel.app/auth/callback
NODE_ENV=development
EOF

# Test enhanced MCP functionality
npm test

# Start local development server
npm run dev

# Deploy to production (when ready)
npm run deploy

"}]} ,{

## Additional sections

Configuration details, security considerations, troubleshooting tips, and notes are included below to help you operate and maintain the MCP server effectively. Ensure your environment variables are kept secure and never committed to version control.

## Configuration and troubleshooting

Endpoint and integration details are exposed for efficient access and testing. Use the MCP URL to interact with the server and verify health and schema endpoints for compatibility with your client.

## Available tools

### find\_brand\_assets

Core MCP function that executes intent parsing, asset search, and result orchestration to return matched assets with formats, usage notes, and download links.

### health

Health and diagnostics endpoint to monitor MCP server status.

### authenticate

OAuth flow integration with Brandfolder to authorize asset access.