imagegen-mcp

MCP server for AI image generation, powered by imagegen.coinopai.com. Payments are handled automatically via x402 micropayments on Base mainnet — no API keys, no subscriptions, just a funded wallet.

Cost: $0.10 USDC per image (Base mainnet)

What it does

Exposes a single generate_image tool that any MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.) can call. When invoked, the server automatically pays the $0.10 USDC gate and returns a PNG image URL.

Requirements

• Node.js 18+
• A Base wallet private key funded with USDC

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "imagegen": {
      "command": "npx",
      "args": ["-y", "coinopai-imagegen"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
      }
    }
  }
}

npx usage

WALLET_PRIVATE_KEY=0x<your-key> npx coinopai-imagegen

Tool reference

generate_image

Generate an AI image from a text prompt.

Inputs:

Parameter	Type	Required	Description
prompt	string	Yes	Natural language image description
aspect	string	No	1:1 (default), 16:9, 9:16, 4:3

Output:

{
  "image_url": "https://...",
  "prompt": "your prompt",
  "aspect": "1:1",
  "generated_at": "2026-05-13T00:00:00.000Z"
}

Example prompts:

• "a cyberpunk wolf in neon rain"
• "a peaceful mountain lake at sunrise, photorealistic"
• "abstract geometric art, vibrant colors, 4K"

Cost disclosure

Each generate_image call costs $0.10 USDC deducted from your WALLET_PRIVATE_KEY wallet on Base mainnet. Use a purpose-built low-balance wallet, not your primary wallet.

$1 USDC ≈ 10 images.

Smithery

Available on Smithery — search for imagegen-mcp.

License

MIT