Skip to content
MCP server

ImageStep

Image pipeline for agents: generate, edit and transform images by id, priced up front

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.2.1
Listing updated
3 days ago

About ImageStep

ImageStep is a freemium MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.imagestep.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.imagestep.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • IMAGESTEP_API_KEYAn ImageStep API key, created at https://imagestep.dev/keys?utm_source=mcp-registry&utm_medium=registry-entryRequired

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $20 a month

Free plan; Pro $20/mo, Max $100/mo; AI ops billed per image from credit

Prices change. Check imagestep.dev before you buy.

ImageStep 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 to ImageStep

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media