# Imagegen MCP

> Imagegen MCP is a paid MCP server for design and media. Pay-per-image generation, background removal, 4x upscaling and photo presets in USDC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Repository:** https://github.com/forgemeshlabs/imagegen-mcp
- **MCP Registry name:** io.github.forgemeshlabs/imagegen-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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

- [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/imagegen-mcp
