developer-toolsapi_key

Imgix

imgix is a real-time image processing and delivery service that enables developers to optimize, transform, and deliver images efficiently.

Verdict

Imgix is an image optimization and transformation API. In Switchy, @mentioning Imgix lets your team adjust brightness, contrast, highlights, or DPI on any hosted image; overlay colors or other images; draw borders; and extract color palettes — all without leaving the conversation. Designers and marketers get instant image variants for campaigns or print. Developers prototype visual treatments in chat before writing code. The MCP requires an Imgix API key and assumes your images already live on an Imgix source domain; it won't upload new assets or manage sources.

Common use cases

  • Generate hero image variants for A/B tests
  • Extract brand colors from competitor screenshots
  • Add watermark overlays to marketing assets
  • Prepare high-DPI images for print collateral
  • Prototype visual treatments before coding

Integration

Vendor
Imgix
Category
developer-tools
Auth
API_KEY
Tools
44
Composio slug
imgix

Tools

  • Adjust Image Brightness

    Tool to adjust image brightness. Use when you need to modify an image's brightness level (−100 to 100) by supplying your source domain and asset path.

  • Adjust Image Contrast

    Tool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).

  • Adjust Image DPI

    Tool to embed DPI (dots-per-inch) metadata for print output on an Imgix-rendered image. Use when preparing images for print to set accurate DPI. Supports JPEG and PNG only.

  • Adjust Image Highlights

    Tool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.

  • Blend Color Over Image

    Tool to blend a solid color over an image using CSS keyword or hex. Use when you need to apply color overlay transformations to an existing image URL.

  • Blend Overlay

    Tool to overlay an image, text, or color onto a base image using imgix blending parameters. Use after specifying the base image URL and blend parameters to composite layers.

  • Draw Image Border

    Tool to draw a border around an image. Use when you need to overlay a border without resizing.

  • Extract Image Color Palette

    Tool to specify how many colors to return when extracting a color palette. Use when you need to control palette size and format.

  • Force Aspect Ratio

    Tool to force a target aspect ratio on an Imgix image. Use when a specific W:H frame is needed after choosing fit=crop or fit=fill. Example: 'ar=16:9&fit=crop&w=800' yields a 16:9, 800px-wide URL.

  • Imgix Auto Optimization

    Tool to apply automatic best-effort image optimizations. Use when you need to compress, enhance, format, or remove redeye via Imgix's auto parameter.

  • Imgix Blend Align

    Tool to align the overlay relative to the base image when blending. Use after constructing a base Imgix URL to specify horizontal and vertical alignment (e.g., 'left,top').

  • Imgix Blend X Position

    Tool to position the overlay horizontally on an Imgix-rendered image. Use when you need to offset the blend layer by a specified number of pixels from the left edge.

  • IMGIX_CH

    Tool to opt in to Client Hints. Use when you want Imgix URLs to adapt based on browser headers (Width, DPR, Save-Data).

  • IMGIX_CROP

    Tool to control cropping alignment and behavior using Imgix's 'crop' parameter.

  • IMGIX_CS

    Tool to set or strip output color space/profile on an Imgix image. Use when optimizing compatibility and file size (e.g., cs=strip for smaller metadata).

  • IMGIX_DL

    Tool to force asset download. Use when you need to download an Imgix asset with a specific filename.

  • IMGIX_FIT

    Tool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.

  • IMGIX_FM

    Tool to choose output file format for the rendered asset. Use after specifying the asset path when you need to convert its format.

  • IMGIX_H

    Tool to set output image height in pixels or as a ratio of the source height. Use after constructing an Imgix URL to adjust only height.

  • IMGIX_LIST_SOURCES

    Tool to list all Sources for an account. Use when you need to retrieve and paginate through sources with optional sorting and filtering.

  • Imgix Mark Height

    Tool to set watermark height on an Imgix URL in pixels or as a ratio of the watermark source. Use when adjusting overlay height while preserving aspect ratio.

  • IMGIX_MARK_PAD

    Tool to set pixel padding between a watermark and the image edge or between tiled watermarks. Use after configuring watermark URL and alignment to adjust spacing precisely.

  • IMGIX_MASK

    Tool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.

  • IMGIX_MAX_H

    Tool to limit output image height. Use when fit=crop is applied to prevent excessively tall images.

  • IMGIX_MAX_W

    Tool to set the maximum output width on an Imgix URL. Use when you need to cap width (works only with fit=crop). Call after specifying fit=crop on the URL.

  • IMGIX_PALETTE

    Tool to extract a color palette from an image in CSS or JSON form. Use when you need to analyze an image's dominant colors after any transformations.

  • IMGIX_RECT

    Tool to select a source-image rectangle region in Imgix before other resizing. Use when you need to crop a specific region (x,y,w,h) of the source image.

  • Imgix Rotate

    Tool to rotate an image on Imgix. Use when you need to apply a counter-clockwise rotation (0–359°) with optional mode control.

  • IMGIX_ROT_TYPE

    Tool to control rotation behavior when `rot` is applied. Use after applying a `rot` parameter to choose between pivot (show entire image) or straighten (zoom and crop) behavior.

  • IMGIX_TXT_ALIGN

    Tool to align a text overlay on an Imgix image. Use when you need to position text by specifying vertical (top/middle/bottom) and horizontal (left/center/right) alignment.

  • IMGIX_TXT_SHAD

    Tool to set text shadow strength for overlay text. Use when you need to apply a drop shadow to text.

  • IMGIX_TXT_SIZE

    Tool to set text font size in pixels. Use when overlaying text and needing precise control over font size. Specify after defining the text content; default is 12px.

  • Imgix URL Expiration

    Tool to append an expiration parameter to an Imgix URL so it returns 404 after a given time. Use when you want the image URL to stop serving beyond a specific UNIX timestamp.

  • Set CSS Palette Prefix

    Tool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.

  • Set Device Pixel Ratio

    Tool to set device pixel ratio for an Imgix image. Use when rendering at specific display densities to ensure correct sharpness. Example: 'dpr=2&w=500&h=300' doubles resolution relative to dimensions.

  • Set Output Quality

    Tool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.

  • Set Text Color

    Tool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.

  • Set Text Font

    Tool to choose font family/style for overlay text. Use when customizing text appearance after specifying content. Supports CSS font categories and optional bold/italic flags.

  • Set Text Outline Width

    Tool to set outline width around overlay text. Use when styling text overlays on images.

  • Set Watermark Base URL

    Tool to set the base URL prepended to the watermark image path. Use when you need to host watermark assets on a custom domain or CDN.

  • Text Outline Color

    Tool to set outline color for text. Use after enabling txt-line on an Imgix URL.

  • Text Overlay

    Tool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.

  • Watermark Fit Mode

    Tool to set how a watermark fits its target dimensions. Use when applying a watermark and you need control over fitting behavior (e.g., selecting 'scale'). For 'crop', ensure 'mark-w' and 'mark-h' are also provided.

  • Watermark Width

    Tool to set watermark width. Use when you need to enforce a watermark's width in pixels or as a proportion. Use after specifying watermark source.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Imgix in the MCP directory and click Connect. 3. You'll be prompted to paste your Imgix API key — generate one from the Imgix dashboard under API Keys if you don't have it. 4. Enter the source domain where your images are hosted (e.g. 'mycompany.imgix.net') so the MCP knows which assets to transform. 5. Click Save to authorize the connection. 6. Open any Space, type '@Imgix adjust brightness to 50 for /hero.jpg' and send — if the MCP replies with a transformed URL, you're connected. 7. From now on, @mention Imgix in any message to invoke brightness, contrast, overlay, border, palette extraction, or DPI adjustments on images already in your Imgix source.

What teammates see: by default, memories from Imgix are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Brighten Product Shot

@Imgix adjust the brightness of /products/shoe-front.jpg to +40 and return the transformed URL
Open in a Space →

Extract Color Palette

@Imgix extract a 6-color palette from /research/competitor-hero.png and show hex codes
Open in a Space →

Overlay Brand Watermark

@Imgix overlay /logos/watermark.png onto /social/event-photo.jpg at 50% opacity in the bottom-right corner
Open in a Space →

Set Print DPI

@Imgix set the DPI of /brochures/cover.jpg to 300 for print output
Open in a Space →

Add Colored Border

@Imgix draw a 10px red border around /slides/chart.png and give me the new URL
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@imgix extract the dominant color palette from our hero image at /marketing/hero-2024.jpg and return the top 5 colors as hex codes

Output

Based on the image at your-domain.imgix.net/marketing/hero-2024.jpg, here are the 5 dominant colors extracted: 1. #2C5F8D (deep blue, 34% coverage) 2. #F4E8D0 (warm beige, 22% coverage) 3. #8BA3B8 (slate gray, 18% coverage) 4. #1A3A52 (navy, 15% coverage) 5. #FFFFFF (white, 11% coverage) These values can be used directly in your design system or CSS variables. The palette extraction analyzed the full-resolution source and weighted by pixel frequency.

Notes

This example shows Imgix's palette extraction capability, which is useful for automated theming or brand consistency checks. Requires a valid source domain configured in your Imgix account and an API key with read access. The tool returns CSS-ready hex codes but does not modify the source image.

Prompt

@imgix create a print-ready version of /products/catalog-item-42.png at 300 DPI, increase contrast by 15, and add a 2px black border

Output

I've generated a print-optimized URL for catalog-item-42.png with the following transformations applied: - DPI metadata: 300 (embedded for print workflows) - Contrast adjustment: +15 - Border: 2px solid black (#000000) Transformed URL: `https://your-domain.imgix.net/products/catalog-item-42.png?dpi=300&con=15&border=2,000000` This URL renders the modified image on-demand. The original PNG remains unchanged. Note that DPI embedding only affects JPEG and PNG formats; other formats will ignore the dpi parameter.

Notes

This demonstrates Imgix's strength in on-the-fly image transformation for production workflows. The MCP constructs parameterized URLs rather than creating new files, so no storage cost is incurred. However, each unique URL counts as a separate render request against your Imgix plan's usage limits.

Prompt

@imgix overlay our watermark logo from /assets/watermark.png onto all images in the /user-uploads folder, positioned bottom-right with 20px padding and 60% opacity

Output

I can generate the blending parameters for this watermark overlay, but applying it to an entire folder requires iteration. Here's the transformation for a single image (/user-uploads/sample.jpg): `https://your-domain.imgix.net/user-uploads/sample.jpg?mark=/assets/watermark.png&mark-align=bottom,right&mark-pad=20&mark-alpha=60` To apply this to all images in /user-uploads, you'd need to list the folder contents (via your own file system or CMS) and generate a transformed URL for each asset. Imgix does not provide batch processing or folder-level operations through this MCP.

Notes

This example highlights both a capability (precise overlay control with positioning and opacity) and a limitation (no native batch operations). The MCP constructs URLs with blend parameters but doesn't iterate over directories. For bulk watermarking, you'd pair this with a separate script or workflow that enumerates files.

Use-case deep-dives

E-commerce product photo batch editing

When Imgix beats manual photo editing for catalog launches

A 6-person e-commerce team launching a seasonal catalog with 400 product photos needs consistent brightness, contrast, and DPI adjustments across SKUs. Imgix wins here because the brightness and contrast tools accept URL parameters—your designer sets the values once, your backend applies them to every image path, and the CDN caches the results. No Photoshop batch jobs, no storage bloat. The trade-off: if you need layer-based edits (masking, selective adjustments), Imgix can't do it—those 44 tools are all single-pass transforms. But for uniform corrections at catalog scale, this MCP turns a 3-day Photoshop sprint into a 20-minute API integration. If your catalog refresh happens monthly or faster, Imgix pays for itself in designer hours.

Marketing asset color overlay automation

When blend tools replace one-off design requests

A 3-person marketing team running weekly social campaigns needs hero images with brand color overlays—same base photo, different tints for each channel. The Blend Color Over Image and Blend Overlay tools let you parameterize the hex code and opacity, so your content manager generates variants without reopening Figma. This works when your base images are already on Imgix and your brand palette is stable (5-8 colors). It breaks down if you need gradient overlays or text positioning that changes per asset—Imgix's text blending is basic, and you can't script layout logic. For high-frequency, low-complexity variants (Instagram vs. LinkedIn color shifts), this MCP cuts turnaround from 2 hours to 2 minutes. If your designer is already the bottleneck on campaign velocity, Imgix unblocks them.

Print-ready image metadata injection

When DPI embedding saves pre-press rework cycles

A 4-person publishing team preparing a quarterly magazine sends 80 images to the printer, who rejects half because DPI metadata is missing or wrong. The Adjust Image DPI tool embeds print-spec metadata (300 DPI for glossy, 150 for newsprint) directly into JPEG and PNG URLs before export. This matters when your images come from multiple sources (stock libraries, contributor uploads, web scrapes) with inconsistent metadata. The limitation: Imgix only supports JPEG and PNG—if your workflow includes TIFF or PSD, you still need a separate step. But for web-to-print pipelines where images are already web-format, this MCP eliminates the pre-press rejection loop. If your printer charges $200/hour for rework, one issue prevented pays for the integration.

Frequently asked

What does the Imgix MCP do in Switchy?

It lets AI agents transform images on the fly using Imgix's URL-based API — adjusting brightness, contrast, DPI, overlaying colors or other images, and extracting color palettes. The MCP doesn't upload or store files; it modifies images already hosted on your Imgix source by appending query parameters to the URL. Useful when you need an agent to prepare assets for print, apply brand overlays, or generate thumbnails without manual editing.

Do I need an Imgix account to use this MCP?

Yes. You need an active Imgix account with at least one configured source (the domain where your images live) and an API key with read access to that source. The MCP authenticates via API key, so you'll paste that into Switchy's connection flow. If you're on a free Imgix trial, the MCP works fine but you'll hit Imgix's bandwidth and request limits, not Switchy's.

Can the Imgix MCP upload new images or edit originals?

No. It only transforms images that already exist on your Imgix source by generating new URLs with transformation parameters. The original file on your S3 bucket, web folder, or CDN stays untouched. If you need to upload a new image first, use a separate file-storage MCP (like AWS S3) to push the file, then point Imgix at it.

How is this different from using Imgix's rendering API directly?

The MCP wraps Imgix's URL parameter syntax so an AI agent can call tools like "Adjust Image Brightness" instead of manually constructing query strings. You get the same output URLs Imgix's API would produce, but the agent doesn't need to memorize parameter names or valid ranges. If you're already scripting Imgix transforms in code, the MCP adds no new capability — it's for delegating image work to an agent.

Who on the team should connect the Imgix MCP?

Whoever manages your Imgix account and can generate an API key. Typically a developer or ops lead. Once connected in Switchy, any team member can ask an agent to transform images, but they'll only see sources the API key has access to. If you want to restrict which images agents can touch, create a dedicated Imgix source with a scoped API key.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.