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

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

All tools accept prompt (required) and aspect (optional: 1:1, 16:9, 9:16, 4:3). generate_image also accepts affiliate_id for Pyrimid attribution, or uses PYRIMID_AFFILIATE_ID from the environment.

---

Install

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

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

Then set the env var:

export WALLET_PRIVATE_KEY=0x...

---

Requirements

• A Base mainnet wallet private key with USDC
• $1 USDC ≈ 4 base images, 2 clean, 2 HD, or 1 pro
• 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_image(prompt="a red panda in a spacesuit", affiliate_id="af_your_id")
→ routes through Pyrimid product 3 with no extra cost to the caller

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

---

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

---

Links

• ForgeMesh — ecosystem overview
• npm
• x402 Protocol

---

License

MIT © ForgeMesh Labs