io.github.forgemeshlabs/imagegen-mcp

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

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.

Links

• ForgeMesh — ecosystem overview
• npm
• x402 Protocol

License

MIT © ForgeMesh Labs