# Imgix — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_imgix?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `imgix_add_asset_from_origin`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/imgix`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/imgix/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/imgix/add/asset/from/origin` — 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
  - body: { source_id: string, origin_path: string }
- `POST https://api.mcp.ai/api/imgix/auto` — 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
  - body: { auto: string[], path: string, source: string }
- `POST https://api.mcp.ai/api/imgix/blend` — 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.
  - body: { 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 }
- `POST https://api.mcp.ai/api/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').
  - body: { vertical?: string, image_url: string, horizontal?: string }
- `POST https://api.mcp.ai/api/imgix/blend/color` — 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.
  - body: { image_url: string, blend_mode?: string, blend_alpha?: integer, blend_color: string }
- `POST https://api.mcp.ai/api/imgix/blend/x` — 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
  - body: { blend: string, blend_x?: integer, image_url: string }
- `POST https://api.mcp.ai/api/imgix/border` — Tool to draw a border around an image. Use when you need to overlay a border without resizing.
  - body: { color: string, width: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/bri` — 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.
  - body: { bri?: number, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/cancel/upload/session` — 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.
  - body: { source_id: string, session_id: string }
- `POST https://api.mcp.ai/api/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).
  - body: { ch: string[], image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/close/upload/session` — 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.
  - body: { source_id: string, session_id: string }
- `POST https://api.mcp.ai/api/imgix/con` — Tool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).
  - body: { con?: number, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/create/imgix/source` — 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
  - body: { data: object }
- `POST https://api.mcp.ai/api/imgix/create/upload/session` — 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
  - body: { source_id: string, origin_path: string }
- `POST https://api.mcp.ai/api/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).
  - body: { cs?: string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/dl` — 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
  - body: { dl?: string, dl64?: string, path: string, source: string }
- `POST https://api.mcp.ai/api/imgix/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.
  - body: { fm?: string, dpi: integer, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/dpr` — 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.
  - body: { h?: integer, w?: integer, dpr?: number, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/expires` — 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.
  - body: { path: string, expires: integer, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/fit` — Tool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.
  - body: { h: integer|number, w: integer|number, fit: string, facepad?: number, faceindex?: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/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.
  - body: { fm: string, path: string, source: string, lossless?: boolean }
- `POST https://api.mcp.ai/api/imgix/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.
  - body: { h?: integer|number, w?: integer|number, ar: string, fit: string, crop?: string, fill?: string, path: string, fill_color?: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/get/source` — Tool to retrieve details for a single imgix Source by its ID. Returns the source configuration including deployment status, type, and settings.
  - body: { source_id: string, fields_sources?: string }
- `POST https://api.mcp.ai/api/imgix/get/upload/session/status` — 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
  - body: { source_id: string, session_id: string }
- `POST https://api.mcp.ai/api/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.
  - body: { h: integer|number, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/high` — Tool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.
  - body: { high?: number, source: string, asset_path: string }
- `POST https://api.mcp.ai/api/imgix/list/assets` — 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.
  - body: { 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 }
- `POST https://api.mcp.ai/api/imgix/list/reports` — 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.
  - body: { sort?: string, fields_reports?: string, filter_completed?: boolean, filter_report_type?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { 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 }
- `POST https://api.mcp.ai/api/imgix/mark/base` — 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.
  - body: { mark_base: string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/mark/fit` — 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
  - body: { mark_fit?: string, image_url: string }
- `POST https://api.mcp.ai/api/imgix/mark/h` — 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.
  - body: { mark: string, mark-h: integer|number, image_url: string }
- `POST https://api.mcp.ai/api/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.
  - body: { url: string, mark-pad?: integer }
- `POST https://api.mcp.ai/api/imgix/mark/w` — 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.
  - body: { mark_w: integer|number, image_url: string }
- `POST https://api.mcp.ai/api/imgix/mask` — Tool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.
  - body: { mask?: string, mask64?: string, mask-bg?: string, image_path: string, corner-radius?: integer|integer[], source_domain: string }
- `POST https://api.mcp.ai/api/imgix/max/h` — 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
  - body: { max-h: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/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.
  - body: { max_w: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/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.
  - body: { colors?: integer, prefix?: string, palette?: string, signature?: string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/prefix` — Tool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.
  - body: { colors?: integer, prefix?: string, palette?: string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/purge/imgix/asset` — 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.
  - body: { url: string, source_id?: string, sub_image?: boolean }
- `POST https://api.mcp.ai/api/imgix/q` — Tool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.
  - body: { q?: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/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.
  - body: { h: integer|number|string, w: integer|number|string, x: integer|number|string, y: integer|number|string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/rot` — Tool to rotate an image on Imgix. Use when you need to apply a counter-clockwise rotation (0–359°) with optional mode control.
  - body: { rot?: integer, path: string, source: string, rot-type?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { rot-type: string, image_url: string }
- `POST https://api.mcp.ai/api/imgix/txt` — Tool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.
  - body: { txt?: string, txt64?: string, image_url: string }
- `POST https://api.mcp.ai/api/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.
  - body: { vertical?: string, horizontal?: string, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/txt/color` — Tool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.
  - body: { image_url: string, txt_color?: string, txt_color64?: string }
- `POST https://api.mcp.ai/api/imgix/txt/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.
  - body: { font: string, image_path: string, use_base64?: boolean, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/txt/line` — Tool to set outline width around overlay text. Use when styling text overlays on images.
  - body: { txt-line: integer, image_url: string }
- `POST https://api.mcp.ai/api/imgix/txt/line/color` — 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
  - body: { color: string, encode?: boolean, image_url: string }
- `POST https://api.mcp.ai/api/imgix/txt/shad` — 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
  - body: { strength?: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/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.
  - body: { size?: integer, image_path: string, source_domain: string }
- `POST https://api.mcp.ai/api/imgix/update/source` — 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
  - body: { data: object, source_id: string }

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

## More
- Page: https://mcp.ai/imgix
- Agent spec (llms.txt): https://mcp.ai/imgix/llms.txt
- Postman collection: https://mcp.ai/imgix/postman.json