Integrates with OpenAI's GPT Image models to generate and edit images, including variations, transparent backgrounds, SVG and GIF output, masks, and multi-reference image editing.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Image generation for your agents.
An MCP server that lets coding agents (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code and any other MCP client) generate, edit and post-process images and save them straight into your project.
It currently runs on OpenAI's GPT Image models (gpt-image-2.6-flare / gpt-image-2.6-sunburst). The provider layer is pluggable, so other backends can be added without changing the tools.
Tool | What it does | Costs money? |
| Text → image. PNG/JPEG/WebP, transparent backgrounds, SVG vector output, short GIF animations, custom sizes up to 3840px, 1–N variations. | Yes |
| Image(s) + instruction → new image. Restyle, recolor, remove backgrounds, add or remove objects, or make a new asset that matches up to 16 reference images. Supports | Yes |
| Local, deterministic ops: resize, crop, trim, pad, rotate, flip, blur, grayscale, flatten, and convert/compress to png/jpeg/webp/gif. Good for exact sizes (favicons, OG images, sprites). | No |
| Dimensions, format, size, frame count, and whether the image actually has transparent pixels. | No |
Every result includes the saved file path, dimensions, a transparency check and a small preview image, so the agent can look at what it made and iterate.
Related MCP server: MCP Image Generator
You need an OpenAI API key with image access.
claude mcp add imagent -e OPENAI_API_KEY=sk-... -- npx -y @1mrnewton/imagent~/.cursor/mcp.json) / Claude Desktop (claude_desktop_config.json){
"mcpServers": {
"imagent": {
"command": "npx",
"args": ["-y", "@1mrnewton/imagent"],
"env": { "OPENAI_API_KEY": "sk-..." }
}
}
}Using Bun? Swap npx -y for bunx.
Generating at high quality can take 30–90 seconds. If your client times out, raise its MCP tool timeout (e.g.
MCP_TOOL_TIMEOUT=180000for Claude Code).
All settings are environment variables:
Variable | Default | |
| — | Required. |
|
| Where files go when no absolute |
|
| Default model for |
|
| Default model for |
|
| Default quality: |
|
| Text model that writes SVG code when |
|
| Most images per call, so a looping agent can't drain your credits. |
|
| Longest edge of the preview returned to the model. |
|
| OpenAI request timeout. |
| — | Optional, e.g. for a proxy or gateway. |
Never overwrites an existing file unless overwrite: true. It saves name-v2.png instead.
output_path ending in / is treated as a directory, and the file gets an automatic name from the prompt.
The output_path extension picks the format when format isn't given (hero.webp → WebP).
Inputs can be local paths, ~/ paths, file://, http(s):// or data: URLs. SVG and GIF inputs are converted to PNG before editing.
SVG output is generate-only with n=1. An image model draws a reference and a text model (svg_model) writes the SVG. GIF output is generate-only.
Without size, edit_image resizes its result back to the source dimensions, so edited assets drop in as replacements.
Previews are small JPEGs, with transparent areas shown on a checkerboard, to keep the agent's context small.
Transparent backgrounds need PNG, WebP or GIF.
OpenAI bills image output by quality and size, plus input tokens for prompts and reference images. See OpenAI's pricing page for current rates. Draft with quality: "low" and make finals at high. process_image and inspect_image are always free.
bun install
bun run dev # run the server over stdio
bun run inspect # open the MCP Inspector against it
bun run typecheck
bun run build # bundle to dist/ (runs on Node ≥ 20 or Bun)To point a client at your local checkout instead of npm:
{ "command": "bun", "args": ["run", "/absolute/path/to/imagent/src/index.ts"], "env": { "OPENAI_API_KEY": "sk-..." } }Implement ImageProvider from src/providers/types.ts (generate and edit).
Register it in src/providers/index.ts.
Select it with IMAGENT_PROVIDER=<id>.
The tools, file handling, previews and process_image stay the same for every provider.
MIT
This server cannot be deployed
Generate on-brand images from your AI agent: design, edit, and render templates over MCP.
Image infrastructure for agents. Upload, transform, and deliver images through MCP, CLI, or API.
Edit images over MCP with object removal, background removal, and guided generative edits.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
