generate_image(prompt, model?, aspect?) — generates an image, saves to /app/generated-images/
list_image_models() — returns ~35 image-capable models (1h cache)

Endpoints

/mcp — MCP Streamable HTTP transport (Bearer-auth required)
/health — liveness probe (no auth)

Auth

Required on every /mcp* request:

Authorization: Bearer $MCP_TOKEN

Riverflow note

Sourceful Riverflow models (sourceful/riverflow-*) live on /api/v1/images instead of /chat/completions — server branches automatically by model id.

Deploy (Coolify)

Build pack: Dockerfile (default). Port 8935 exposed on the container. Env vars required:

OPENROUTER_API_KEY
MCP_TOKEN

Volume: /app/generated-images (persistent).

Client config

{
  "mcpServers": {
    "img-gen": {
      "url": "https://<host>.193.43.72.4.sslip.io/mcp",
      "headers": { "Authorization": "Bearer <MCP_TOKEN>" }
    }
  }
}