SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Imgix MCP with Hermes

Connect Hermes to Imgix MCP. Auto-optimize all images in this folder, overlay company logo on product photos, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Imgix logoImgix
Api Key

Imgix is a real-time image processing and delivery service for developers. It helps you optimize, transform, and deliver images efficiently at any scale.

53 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Imgix account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Imgix with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKGrok BotCodexOpenClawAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Imgix with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Imgix

Ask your agent to connect to Imgix, or simply request any Imgix-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Imgix connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Imgix or request any Imgix-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Imgix MCP server, and what's possible with it?

The Imgix MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Imgix account. It provides structured and secure access to your image library, so your agent can perform actions like optimizing images, applying overlays, adjusting visual properties, and extracting color palettes on your behalf.

  • Real-time image optimization: Ask your agent to automatically compress, enhance, or format images for faster delivery and better quality using Imgix's auto optimization tools.
  • Dynamic overlays and blending: Direct the agent to blend images, text, or solid colors over your base images—perfect for watermarks, banners, or creative composites.
  • Precision image adjustments: Have your agent modify image brightness, contrast, and border settings to meet your design and branding needs instantly.
  • Extract and analyze color palettes: Let your agent pull color palettes from any image, making it easy to generate theme colors or analyze brand consistency.
  • Fine-tune overlay positioning: Control exactly where overlays appear on your images by specifying alignment and pixel-level positioning through your agent.

Way Forward

With Imgix connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Imgix action and event your agent gets out of the box.

IMGIX_ADD_ASSET_FROM_ORIGIN

Tool to queue a path from your origin to be added to the Asset Manager.

Imgix Auto Optimization

Apply automatic image optimizations using imgix's auto parameter.

Blend Overlay

Tool to overlay an image, text, or color onto a base image using imgix blending parameters.

Imgix Blend Align

Tool to align the overlay relative to the base image when blending.

Blend Color Over Image

Construct an image URL with a solid color overlay using a CSS keyword or hex color.

Imgix Blend X Position

Position an overlay image horizontally on a base image using imgix's blend-x parameter.

Draw Image Border

Tool to draw a border around an image.

Adjust Image Brightness

Tool to adjust image brightness.

IMGIX_CANCEL_UPLOAD_SESSION

Tool to cancel an Imgix Asset Manager upload session.

IMGIX_CH

Fetch an Imgix image with selected Client Hints options for Width, DPR, or Save-Data and return it as a downloadable file.

IMGIX_CLOSE_UPLOAD_SESSION

Tool to close an Imgix Asset Manager upload session after the client uploads to the presigned URL.

Adjust Image Contrast

Tool to adjust image contrast.

IMGIX_CREATE_IMGIX_SOURCE

Tool to create and deploy a new imgix Source.

IMGIX_CREATE_UPLOAD_SESSION

Tool to create an Imgix Asset Manager upload session and return a presigned URL for client-side upload.

IMGIX_CS

Tool to set or strip output color space/profile on an Imgix image.

IMGIX_DL

Download an asset from an Imgix source with optional custom filename.

Adjust Image DPI

Tool to embed DPI (dots-per-inch) metadata for print output on an Imgix-rendered image.

Set Device Pixel Ratio

Tool to set device pixel ratio for an Imgix image.

Imgix URL Expiration

Tool to append an expiration parameter to an Imgix URL so it returns 404 after a given time.

IMGIX_FIT

Tool to control how an image fits target dimensions after resizing.

IMGIX_FM

Tool to choose output file format for the rendered asset.

Force Aspect Ratio

Tool to force a target aspect ratio on an Imgix image.

IMGIX_GET_SOURCE

Tool to retrieve details for a single imgix Source by its ID.

IMGIX_GET_UPLOAD_SESSION_STATUS

Tool to retrieve the status of an Imgix Asset Manager upload session.

IMGIX_H

Fetch an Imgix image with its output height set in pixels or as a ratio of the source height.

Adjust Image Highlights

Tool to adjust highlight tonal mapping (−100 to 0).

IMGIX_LIST_ASSETS

Tool to retrieve a paginated list of assets in an imgix Source.

IMGIX_LIST_REPORTS

Retrieve a list of available reports for an Imgix account, with optional filters and sorting, for access to analytics and usage information.

IMGIX_LIST_SOURCES

Tool to list all Sources for an account.

Set Watermark Base URL

Tool to set the base URL prepended to the watermark image path.

Watermark Fit Mode

Tool to set how a watermark fits its target dimensions.

Imgix Mark Height

Tool to set watermark height on an Imgix URL in pixels or as a ratio of the watermark source.

IMGIX_MARK_PAD

Set pixel padding between a watermark and the image edge or between tiled watermarks by returning an Imgix URL with the padding parameter applied.

Watermark Width

Set watermark width in an Imgix image URL and return the modified URL.

IMGIX_MASK

Tool to apply a mask to an image.

IMGIX_MAX_H

Constrain the maximum height of an imgix image.

IMGIX_MAX_W

Request an Imgix image with a maximum output width and return it as a downloadable file.

IMGIX_PALETTE

Extract a color palette from an Imgix image in CSS or JSON form for analyzing its dominant colors.

Set CSS Palette Prefix

Tool to set class-name prefix for CSS palette output.

IMGIX_PURGE_ASSET

Tool to purge an asset from the imgix cache.

Set Output Quality

Tool to set output quality for lossy formats.

IMGIX_RECT

Tool to select a source-image rectangle region in Imgix before other resizing.

Imgix Rotate

Tool to rotate an image on Imgix.

IMGIX_ROT_TYPE

Set rotation behavior to pivot or straighten on an Imgix image URL that already has a rotation parameter, and return the modified URL.

Text Overlay

Tool to render a single-line UTF-8 text overlay on an image.

IMGIX_TXT_ALIGN

Request an Imgix image with vertical and horizontal text-overlay alignment parameters and return the image as a downloadable file.

Set Text Color

Set text-overlay color in an Imgix image URL using a CSS color keyword, hex code, or encoded color value, and return the modified URL.

Set Text Font

Request an Imgix image with a font family and style for overlay text and return it as a downloadable file.

Set Text Outline Width

Set the outline width for overlay text in an Imgix image URL, returning the modified URL.

Text Outline Color

Apply an outline color to text overlays on Imgix images.

IMGIX_TXT_SHAD

Fetch an Imgix image with an optional text shadow strength from 0 to 10 and return it as a downloadable file.

IMGIX_TXT_SIZE

Fetch an Imgix image with a text font size in pixels, defaulting to 12px.

IMGIX_UPDATE_SOURCE

Update an existing Imgix Source's name, enabled status, or deployment configuration.

FRAMEWORKS

How to build Imgix MCP Agent with another framework

Claude Code logo

Claude Code

Use Imgix MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Imgix MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Imgix MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Imgix MCP with Claude Agent SDK

Grok Bot logo

Grok Bot

Use Imgix MCP with Grok Bot

Codex logo

Codex

Use Imgix MCP with Codex

OpenClaw logo

OpenClaw

Use Imgix MCP with OpenClaw

Atomic Agent logo

Atomic Agent

Use Imgix MCP with Atomic Agent

Google ADK logo

Google ADK

Use Imgix MCP with Google ADK

LangChain logo

LangChain

Use Imgix MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Imgix MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Imgix MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Imgix MCP with LlamaIndex

CrewAI logo

CrewAI

Use Imgix MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Imgix MCP with Pydantic AI

AutoGen logo

AutoGen

Use Imgix MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Imgix MCP server, the agents and LLMs can only access a fixed set of Imgix tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Imgix and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Imgix tools.

Yes, absolutely. You can configure which Imgix scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Imgix data and credentials are handled as safely as possible.

Start with Imgix.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Imgix tool your agent needs.Free to start.

Start building