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:

config.json

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

Claude Code

Terminal

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

Then set the env var:

server.ts

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

Code

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

Imagegen MCP README