# imgix (Real-time Image Processing) MCP

> imgix MCP gives you full control over your image CDN infrastructure through natural conversation. You manage sources, purge assets, and monitor connections to ensure every picture loads fast and correctly across all devices.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** cdn, image-processing, asset-optimization, real-time-transformation, media-delivery, cache-purging

## Description

Managing media delivery used to mean jumping between dashboards: checking if the origin was connected, manually purging specific asset URLs from cache, or running reports on source health. Now, you connect your imgix account to any agent via Vinkius and manage your entire image pipeline using natural language commands. You can tell your AI client to list all your current sources, verify which ones are live, and even delete old ones with a single prompt. Need to fix an asset? Simply ask the agent to purge a specific file path across the global network. This capability lets you treat complex infrastructure management like talking to a teammate: direct, immediate, and actionable. You don't need to learn Imgix API calls; your agent handles the complexity.

## Tools

### list_sources
Lists all connected imgix sources, providing a quick overview of your current CDN setup.

### get_source
Retrieves specific details about one imgix source, including its domain and deployment type.

### create_source
Connects a new origin storage location (like S3 or GCS) to the imgix CDN for processing.

### update_source
Modifies settings on an existing source, such as its caching rules or deployment type.

### enable_source
Activates a configured imgix source, making it live and ready to serve images across the network.

### disable_source
Takes an imgix source offline immediately, stopping all image serving from that connection.

### purge
Removes a specific file and all its processed versions from the global imgix cache, forcing immediate re-fetch.

### list_assets
Returns a list of files within an imgix source, showing their paths, sizes, and content types.

### get_asset
Retrieves the full metadata for one specific asset path in an imgix source.

### delete_source
Permanently removes a configured imgix source from your account.

## Prompt Examples

**Prompt:** 
```
List all my current imgix sources
```

**Response:** 
```
I've found 3 imgix sources: 'marketing-assets' (ID: src_123), 'e-commerce-products' (ID: src_456), and 'user-uploads' (ID: src_789). Which one would you like to inspect?
```

**Prompt:** 
```
Purge this image from CDN: https://mycompany.imgix.net/logos/v2.png
```

**Response:** 
```
Purge request sent. I've invalidated 'logos/v2.png' across the global imgix Edge network. All processed versions of this file will now be re-fetched and transformed from your origin.
```

**Prompt:** 
```
List the assets in the 'marketing-assets' source
```

**Response:** 
```
I've retrieved the assets for source 'src_123'. Recent files include '/banners/hero-winter.jpg', '/icons/social-bundle.svg', and '/product-shots/model-01.webp'. Total assets in this source: 1,245.
```

## Capabilities

### Manage Image Sources
You can list, create, update, or delete connections between your original storage (like S3) and the imgix CDN.

### Invalidate Cache Assets
Send a command to purge specific files across the global network, forcing all viewers to download the newest version from your source.

### Audit Asset Libraries
Retrieve comprehensive lists of assets within any connected source, including file paths and sizes.

### Monitor Source Health
Get detailed status checks on your sources, confirming if they are active or need maintenance.

### Control Deployment State
Enable or disable entire image sources instantly to manage traffic flow during updates or downtime.

## Use Cases

### A hero image is showing a cached version after I updated the original file.
The developer asks their agent: 'Purge this specific banner image from the CDN.' The agent executes the `purge` tool, invalidating the asset globally and ensuring the viewer gets the latest version immediately.

### We need to verify if our new user upload folder is correctly connected to imgix.
The SRE asks their agent: 'List my sources and get details for the user uploads connection.' The agent runs `list_sources` followed by `get_source`, confirming deployment status before traffic hits it.

### Before deleting a source, I need to know what files are stored there.
The DAM asks their agent: 'List all assets in the marketing-assets source.' The agent runs `list_assets` and provides an immediate inventory count and sample file paths for audit purposes.

### We need to temporarily take a product line off sale without deleting its entire connection.
The developer asks their agent: 'Disable the e-commerce sources.' The agent calls `disable_source`, instantly stopping traffic flow and preventing accidental image serving until it's re-enabled.

## Benefits

- Fixing stale images is simple. Instead of guessing which cache layer needs clearing, just ask the agent to run `purge` on a specific file path and invalidate it globally across the imgix Edge network.
- You can build complex pipelines without leaving your IDE. Use this MCP within Cursor or VS Code to verify origin connections or manage CDN deployment states with simple conversation prompts.
- Never lose track of what assets belong where. Running `list_assets` gives you an instant inventory check, listing paths and sizes for any source so you know exactly what's available.
- When a new product line launches, simply tell the agent to use `create_source`. It handles connecting your raw storage (S3/GCS) directly into the CDN pipeline.
- Manage traffic flow with confidence. You can instantly disable an entire source using `disable_source` if you need maintenance time, or enable it again when ready.

## How It Works

The bottom line is that you talk to the MCP like talking to a DevOps teammate; it handles the complex API calls for image delivery management.

1. Subscribe to this MCP and provide your imgix API Key.
2. Connect the credential set to your preferred AI client (Claude, Cursor, etc.).
3. Tell your agent exactly what you need—for example, 'Purge all assets related to our holiday campaign'—and execute commands through conversation.

## Frequently Asked Questions

**How do I check if a specific image source is active using imgix MCP?**
Use the `get_source` tool to retrieve details about that connection. This returns its name, domain, and current deployment status, confirming if it's live or disabled.

**What should I use if I need to remove a file from the cache?**
You must run the `purge` tool, providing the exact asset path. This action invalidates all processed derivatives of that file across the global network immediately.

**Can imgix MCP help me audit my current image sources?**
Yes, start by using `list_sources`. This gives you a comprehensive list of every connection currently configured on your account in one go.

**Do I need to use the create_source tool for every new image upload?**
No. You only use `create_source` when you are connecting an entirely new storage location (like a second GCS bucket) to the CDN pipeline.

**What's the difference between list_assets and get_asset in imgix MCP?**
`list_assets` shows you everything available in a source. `get_asset` lets you drill down and retrieve detailed metadata for one specific file path.