# Imgix — MCP server on mcp.ai
> Connect your Imgix account and use 53 tools for images and design straight from your AI agent. Connect with your own API key. imgix is a real-time image processing and delivery service that enables developers to optimize, transform, and deliver images efficiently.

By: mcp.ai · official
Page: https://mcp.ai/imgix

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_imgix?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/imgix/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/imgix/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/imgix/skill.md
Postman collection (v2.1): https://mcp.ai/imgix/postman.json

## Tools
- imgix_add_asset_from_origin(source_id: string, origin_path: string) — Tool to queue a path from your origin to be added to the Asset Manager. Imports the asset metadata without uploading the asset itself. Use when you need to register an existing origin-hosted file with
- imgix_auto(auto: string[], path: string, source: string) — Apply automatic image optimizations using imgix's auto parameter. Use this tool to automatically optimize images for web delivery. Common use cases: - Reduce file sizes with 'compress' for faster page
- imgix_blend(blend?: string, blend64?: string, blend_h?: number, blend_w?: number, blend_x?: integer, blend_y?: integer, blend_fit?: string, blend_pad?: integer, blend_crop?: string, blend_mode?: string, blend_size?: string, blend_align?: string, blend_alpha?: integer, blend_color?: string, base_image_url: string) — 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.
- imgix_blend_align(vertical?: string, image_url: string, horizontal?: string) — 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_color(image_url: string, blend_mode?: string, blend_alpha?: integer, blend_color: string) — 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.
- imgix_blend_x(blend: string, blend_x?: integer, image_url: string) — Position an overlay image horizontally on a base image using imgix's blend-x parameter. Use this tool when you need to place an overlay (image or color) at a specific horizontal offset from the left e
- imgix_border(color: string, width: integer, image_path: string, source_domain: string) — Tool to draw a border around an image. Use when you need to overlay a border without resizing.
- imgix_bri(bri?: number, source: string, asset_path: string) — 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.
- imgix_cancel_upload_session(source_id: string, session_id: string) — Tool to cancel an Imgix Asset Manager upload session. Use when you need to abort an in-progress or abandoned upload flow and clean up the session.
- imgix_ch(ch: string[], image_path: string, source_domain: string) — Tool to opt in to Client Hints. Use when you want Imgix URLs to adapt based on browser headers (Width, DPR, Save-Data).
- imgix_close_upload_session(source_id: string, session_id: string) — Tool to close an Imgix Asset Manager upload session after the client uploads to the presigned URL. Use after uploading a file to expedite asset processing. Closing is strongly recommended by imgix.
- imgix_con(con?: number, source: string, asset_path: string) — Tool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).
- imgix_create_imgix_source(data: object) — Tool to create and deploy a new imgix Source. Use when you need to add a new image source with deployment configuration for S3, Web Folder, Web Proxy, GCS, Azure, or S3-compatible storage. Requires so
- imgix_create_upload_session(source_id: string, origin_path: string) — Tool to create an Imgix Asset Manager upload session and return a presigned URL for client-side upload. Use when you need to upload a new image to a storage-backed imgix Source without requiring exter
- imgix_cs(cs?: string, image_path: string, source_domain: string) — 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(dl?: string, dl64?: string, path: string, source: string) — Download an asset from an Imgix source with optional custom filename. Use this tool when you need to: - Download images or assets from an Imgix CDN source - Force a specific download filename (via 'dl
- imgix_dpi(fm?: string, dpi: integer, source: string, asset_path: string) — 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.
- imgix_dpr(h?: integer, w?: integer, dpr?: number, source: string, asset_path: string) — 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.
- imgix_expires(path: string, expires: integer, source_domain: string) — 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.
- imgix_fit(h: integer|number, w: integer|number, fit: string, facepad?: number, faceindex?: integer, image_path: string, source_domain: string) — Tool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.
- imgix_fm(fm: string, path: string, source: string, lossless?: boolean) — Tool to choose output file format for the rendered asset. Use after specifying the asset path when you need to convert its format.
- imgix_force_aspect_ratio(h?: integer|number, w?: integer|number, ar: string, fit: string, crop?: string, fill?: string, path: string, fill_color?: string, source_domain: string) — 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_get_source(source_id: string, fields_sources?: string) — Tool to retrieve details for a single imgix Source by its ID. Returns the source configuration including deployment status, type, and settings.
- imgix_get_upload_session_status(source_id: string, session_id: string) — Tool to retrieve the status of an Imgix Asset Manager upload session. Use when you need to check the current state (PENDING/CLOSED/COMPLETE/CANCELED) of an upload session for polling or verification a
- imgix_h(h: integer|number, source: string, asset_path: string) — 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_high(high?: number, source: string, asset_path: string) — Tool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.
- imgix_list_assets(sort?: string, source_id: string, page_limit?: integer, filter_tags?: string, page_cursor?: string, filter_colors?: string, filter_keyword?: string, filter_categories?: string, filter_face_count?: string, filter_has_frames?: boolean, filter_media_kind?: string, filter_origin_path?: string, filter_warning_racy?: string, filter_warning_adult?: string, filter_warning_spoof?: string, filter_warning_medical?: string, filter_warning_violence?: string) — Tool to retrieve a paginated list of assets in an imgix Source. Use when you need to list, filter, or search assets with cursor-based pagination and sorting.
- imgix_list_reports(sort?: string, fields_reports?: string, filter_completed?: boolean, filter_report_type?: string) — Tool to retrieve a list of all available reports for your imgix account. Use when you need to access analytics and usage information. Reports are generated daily and retained for 90 days.
- imgix_list_sources(sort?: string, page_size?: integer, filter_name?: string, page_number?: integer, fields_sources?: string, filter_enabled?: boolean, filter_deployment_type?: string, filter_deployment_region?: string, filter_deployment_s3_bucket?: string, filter_deployment_gcs_bucket?: string, filter_deployment_bucket_name?: string, filter_deployment_azure_bucket?: string, filter_deployment_custom_domains?: string, filter_deployment_imgix_subdomains?: string, filter_deployment_storage_provider?: string, filter_deployment_webfolder_base_url?: string) — 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_base(mark_base: string, image_path: string, source_domain: string) — 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.
- imgix_mark_fit(mark_fit?: string, image_url: string) — 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
- imgix_mark_h(mark: string, mark-h: integer|number, image_url: string) — 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(url: string, mark-pad?: integer) — 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_mark_w(mark_w: integer|number, image_url: string) — 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.
- imgix_mask(mask?: string, mask64?: string, mask-bg?: string, image_path: string, corner-radius?: integer|integer[], source_domain: string) — Tool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.
- imgix_max_h(max-h: integer, image_path: string, source_domain: string) — Constrain the maximum height of an imgix image. This tool applies fit=crop along with the max-h parameter to ensure images do not exceed the specified height. Ideal for vertically-scrolling feeds or g
- imgix_max_w(max_w: integer, image_path: string, source_domain: string) — 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(colors?: integer, prefix?: string, palette?: string, signature?: string, image_path: string, source_domain: string) — 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_prefix(colors?: integer, prefix?: string, palette?: string, image_path: string, source_domain: string) — Tool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.
- imgix_purge_imgix_asset(url: string, source_id?: string, sub_image?: boolean) — Tool to purge an asset from the imgix cache. Use when you need to invalidate cached versions of an image and force imgix to fetch a fresh version from origin on the next request.
- imgix_q(q?: integer, image_path: string, source_domain: string) — Tool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.
- imgix_rect(h: integer|number|string, w: integer|number|string, x: integer|number|string, y: integer|number|string, image_path: string, source_domain: string) — 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_rot(rot?: integer, path: string, source: string, rot-type?: string) — 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(rot-type: string, image_url: string) — 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(txt?: string, txt64?: string, image_url: string) — Tool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.
- imgix_txt_align(vertical?: string, horizontal?: string, image_path: string, source_domain: string) — 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_color(image_url: string, txt_color?: string, txt_color64?: string) — Tool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.
- imgix_txt_font(font: string, image_path: string, use_base64?: boolean, source_domain: string) — 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.
- imgix_txt_line(txt-line: integer, image_url: string) — Tool to set outline width around overlay text. Use when styling text overlays on images.
- imgix_txt_line_color(color: string, encode?: boolean, image_url: string) — Apply an outline color to text overlays on Imgix images. The text outline must first be enabled using the txt-line parameter (outline width > 0). This action fetches and returns the rendered image wit
- imgix_txt_shad(strength?: integer, image_path: string, source_domain: string) — Set text shadow strength for imgix text overlays. The txt-shad parameter controls the drop shadow intensity (0-10) applied to text rendered on images. Note: This parameter only has a visible effect wh
- imgix_txt_size(size?: integer, image_path: string, source_domain: string) — 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_update_source(data: object, source_id: string) — Tool to update an existing imgix Source. Use when you need to modify source name, deployment configuration, bucket settings, or other source attributes. Deployment changes trigger automatic redeployme

## Example prompts
- "What can I do in Imgix?"
- "Show me a summary of my Imgix account"

## Links
Docs: https://mcp.ai/docs/mcps/imgix
Website: https://mcp.ai/mcps/imgix