# ImageStep

> ImageStep is a freemium MCP server for design and media. Image pipeline for agents: generate, edit and transform images by id, priced up front. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $20 a month
- **Platforms:** API, CLI
- **Website:** https://imagestep.dev/docs/mcp
- **Repository:** https://github.com/imagestep/imagestep-sdk/tree/HEAD/packages/mcp
- **MCP Registry name:** dev.imagestep/mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

ImageStep's server hands an agent generation, editing and clean-up operations without image bytes ever entering the context window. Every tool takes and returns references such as asset ids, sizes and public URLs, jobs can be priced with a dry run before any money is spent, and failures say whether a retry is worthwhile.

It runs two ways. Locally over stdio (`@imagestep/mcp`, Node 20+) it can upload files from disk and waits up to 600 seconds per call. The hosted Streamable HTTP server at mcp.imagestep.dev needs nothing installed, takes asset ids or public URLs, and caps a wait at 90 seconds before returning a job handle. Both need an ImageStep API key. The README notes that file paths through hidden folders are refused and can be limited to client roots.

Pricing is per image: AI operations are paid from a credit balance at no more than 1.5 times the provider's list price, and deterministic operations are free on paid plans.

## Features

- **Reference-based tools:** Tools exchange asset ids and URLs instead of image data.
- **Dry-run pricing:** Any job can return its exact cost before anything is created.
- **Versioned presets:** Save a chain of steps and run it again for consistent batches.
- **Local and hosted modes:** Stdio server uploads disk files; hosted server needs no install.
- **Structured errors:** Failures include whether they are retryable and the request id.
- **Variants:** One call can run an operation once per variant, such as many social sizes.

## Good for

- Generate product images with a saved preset
- Remove backgrounds from a batch of photos
- Upscale or restore old photos
- Produce every social media size from one source image
- Analyze images into structured JSON

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.imagestep.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.imagestep.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.imagestep.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.imagestep.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.imagestep.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.imagestep.dev/mcp"
    }
  }
}
```

## Tools

- `generate`: Prompt to image(s), returns asset ids and CDN URLs; can run through a saved preset
- `transform`: Runs one atomic operation such as edit, remove_bg, upscale, resize or analyze
- `run_preset`: Runs a saved, versioned preset, a list of steps
- `job_status`: Per-item progress and outputs of a job
- `search_assets`: Finds assets by collection, keyword, mime or size
- `save_preset`: Saves a chain of steps as a named, versioned preset
- `send_feedback`: Reports what ImageStep could not do

## FAQ

### Do I need an API key?

Yes, both the local and hosted servers need an ImageStep API key.

### What does it cost?

Free plan is $0 with a $3 one-time AI credit; Pro is $20 a month and Max is $100 a month.

### Can it read files from my computer?

Only the local stdio server can, and it refuses hidden paths.

### Can I see the price first?

Yes, a dry run returns the exact cost without creating anything.

### Is ImageStep free?

ImageStep has a free plan, with paid plans for more usage or features. Paid plans start at $20 a month.

### How do I add ImageStep to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.imagestep.dev/mcp

### What are the best alternatives to ImageStep?

The closest alternatives to ImageStep are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/imagestep
