Content
# 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](https://github.com/forgemeshlabs/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`:
```json
{
"mcpServers": {
"forgemesh-imagegen": {
"command": "npx",
"args": ["-y", "forgemesh-imagegen"],
"env": {
"WALLET_PRIVATE_KEY": "0x...",
"PYRIMID_AFFILIATE_ID": "af_your_id"
}
}
}
}
```
### Claude Code
```bash
claude mcp add forgemesh-imagegen -- npx -y forgemesh-imagegen
```
Then set the env var:
```bash
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](https://coinbase.com) → 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](https://x402.org). 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](https://x402.org)
---
## Links
- [ForgeMesh](https://github.com/forgemeshlabs/forgemesh) — ecosystem overview
- [npm](https://www.npmjs.com/package/forgemesh-imagegen)
- [x402 Protocol](https://x402.org)
---
## License
MIT © ForgeMesh Labs
