How do I install Imagegen?

Imagegen is a local plugin. Install it using npm package: forgemesh-imagegen and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Imagegen safe to use?

Yes. Imagegen passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Imagegen need?

Imagegen requires the following credentials or environment variables: WALLET_PRIVATE_KEY. You can find setup instructions on the server detail page.

What AI apps work with Imagegen?

Imagegen uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Imagegen MCP Server

by ForgeMesh

Developer ToolsLow Risk10.0Local

Free

AI image generation MCP — generate, bg removal, 4x upscale, or full pro pipeline. USDC/Base.

About

AI image generation MCP — generate, bg removal, 4x upscale, or full pro pipeline. USDC/Base.

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (37/39 approved).

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: WALLET_PRIVATE_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-forgemeshlabs-imagegen-mcp": {
      "env": {
        "WALLET_PRIVATE_KEY": "your-wallet-private-key-here"
      },
      "args": [
        "-y",
        "forgemesh-imagegen"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

forgemesh-imagegen

MCP server for AI image generation. Generate images, remove backgrounds, upscale to 4x HD — all from a single MCP tool call. Payments handled automatically in USDC on Base mainnet via x402. No API key. No subscription. Pay per image.

Part of the ForgeMesh ecosystem — infrastructure for autonomous agents.

Tools

Tool	What it does	Price
`generate_image`	Standard text-to-image generation	$0.25 USDC
`generate_clean`	Generate + background removal	$0.35 USDC
`generate_hd`	Premium generate + 4x upscale (HD)	$0.50 USDC
`generate_pro`	Top-tier generate + bg removal + 4x upscale	$0.75 USDC
`list_presets`	List the 58 identity-preserving transform presets (person or pet)	$0.005 USDC
`transform_image`	Transform a photo with a preset while keeping the subject's identity (FLUX Kontext Max)	$0.75 USDC

The four generate_* tools accept prompt (required) and aspect (optional: 1:1, 16:9, 9:16, 4:3). transform_image takes a public image_url, a preset id from list_presets, an optional aspect (match_input_image default, or 1:1, 16:9, 9:16, 4:3, 3:4) and wait (default true: polls the free status URL until the PNG is ready, usually 15-30s). Submit only images you have rights to; no minors; the provider safety filter applies.

Install

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "forgemesh-imagegen": {
      "command": "npx",
      "args": ["-y", "forgemesh-imagegen"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

claude mcp add forgemesh-imagegen -- npx -y forgemesh-imagegen

Then set the env var:

export WALLET_PRIVATE_KEY=0x...

Requirements

A dedicated, low-balance Base mainnet wallet private key with USDC (never your primary wallet: the server signs USDC transfers autonomously)
$1 USDC ≈ 4 base images, 2 clean, 2 HD, or 1 pro, or 1 transform
No other API keys needed

Get USDC on Base: Coinbase → Bridge to Base, or buy directly on Base.

Example usage

generate_image(prompt="a red panda in a spacesuit", aspect="1:1")
→ { image_url: "https://...", prompt: "...", aspect: "1:1", tier: "image" }

generate_clean(prompt="a product photo of a ceramic mug")
→ { image_url: "https://...", tier: "clean" }   // transparent PNG

generate_hd(prompt="a futuristic city at night, cyberpunk style")
→ { image_url: "https://...", tier: "hd" }       // 4096x4096

generate_pro(prompt="a logo mark, geometric eagle")
→ { image_url: "https://...", tier: "pro" }      // transparent + HD

list_presets()
→ { count: 58, presets: [{ id: "pet-royal", title: "Pet Royalty", subject: "pet", ... }, ...] }

transform_image(image_url="https://example.com/my-dog.jpg", preset="pet-royal")
→ { job_id: "...", status: "succeeded", preset: "pet-royal", image_url: "https://..." }

How it works

Each tool call makes an HTTP request to the ForgeMesh imagegen service gated by the x402 protocol. If payment is required, the MCP automatically signs and broadcasts a USDC transfer from your wallet on Base mainnet — then retries the request. You see the result, your wallet is charged, no manual steps.

Network: Base mainnet (eip155:8453)
Token: USDC
Protocol: x402
The server only ever connects to https://imagegen.coinopai.com; every request has a 60s timeout and a 1 MB response cap; no third-party payment routers or affiliate hops.