Skip to content
MCP server

Imagegen MCP

Pay-per-image generation, background removal, 4x upscaling and photo presets in USDC

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
API, CLI
Runs
Locally
Version
2.1.3
Listing updated
2 days ago

About Imagegen MCP

Imagegen MCP is a paid MCP server for design and media. It runs locally on your machine and is started by your AI client.

Prices climb with the pipeline: $0.05 for a standard text-to-image, $0.35 for a clean version with the background removed, $0.10 for an HD result upscaled to 4096 by 4096, and $0.75 for the pro tier that does all three. A sixth tool, transform_image, restyles a photo of a person or pet with one of 58 identity-preserving presets using FLUX Kontext Max for $0.75, and list_presets costs half a cent.

HD, pro and transform jobs run asynchronously: the tool polls a free status URL for up to about 90 seconds and returns an image URL with an expiry, since images are stored for seven days. If a job fails on the service side it returns a retry credit for one free retry within 72 hours. Synchronous renders over 85 seconds answer 504 and are not charged. The README asks you to submit only images you have rights to, no minors.

Payment is x402 USDC on Base from a dedicated low-balance wallet, roughly four base images per dollar. The server connects only to the ForgeMesh imagegen service.

Install

Run in a terminal

claude mcp add imagegen-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y forgemesh-imagegen

Add to claude_desktop_config.json

{
  "mcpServers": {
    "imagegen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "imagegen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "imagegen-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "imagegen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "imagegen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • WALLET_PRIVATE_KEYBase wallet private key for x402 USDC micropayments. Use a dedicated low-balance wallet.Required

Tools this server provides (6)

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

generate_image
Standard text-to-image generation
generate_clean
Generate with background removal
generate_hd
Generate with 4x upscale
generate_pro
Generate, remove background and upscale
list_presets
List the identity-preserving transform presets
transform_image
Transform a photo with a preset

What it does

Four generation tiers
Standard, clean, HD and pro outputs at rising prices.
Background removal
Produces transparent PNGs from a prompt.
4x upscaling
Delivers 4096 by 4096 results.
Photo presets
58 identity-preserving transforms for people and pets.
Retry credit
One free retry after a service-side failure.
Aspect choices
Supports 1:1, 16:9, 9:16 and 4:3.

Good for

  • Generate a logo mark with a transparent background
  • Make a product photo cutout
  • Turn a pet photo into a styled portrait
  • Upscale generated art for print

Pricing

Paid

Per image in USDC: $0.05 to $0.75

Imagegen MCP FAQ

How much is one image?

A standard image costs $0.05; clean is $0.35, HD $0.10 and pro $0.75.

How long are images kept?

Seven days, per the README.

What if a job fails?

Service-side failures return a retry credit for one free retry within 72 hours.

What do I need to run it?

A dedicated Base wallet private key holding USDC; no other API key.

Is Imagegen MCP free?

No. Imagegen MCP is a paid product.

How do I add Imagegen MCP to Claude Code?

Run this command in your terminal: claude mcp add imagegen-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y forgemesh-imagegen

What are the best alternatives to Imagegen MCP?

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

Alternatives to Imagegen MCP

  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