Check whether a background image generation has finished.

Call this after generate_image to wait for completion. Returns a short JSON status — no image data, no heavy UI.

• "completed" → call show_image(uri=original_uri) to display the finished image.

• "generating" → wait and check again.

• "failed" → report the error to the user.

Display a completed image with optional on-demand transforms.

Only call this for completed images — use check_generation_status to poll, then call this once when status is "completed".

Accepts a full image:// resource URI (e.g. image://abc123/view or image://abc123/view?format=webp&width=512). Transforms are encoded in the URI query string — no separate parameters needed.

Read the image://list resource to browse available image IDs.

Browse all generated images in an interactive visual gallery.

Opens a gallery view showing thumbnail previews of images in the scratch directory, filtered by origin (generated images by default).

For non-UI clients the response is a JSON object with total, page, page_size, origin, and items. Each completed item includes image_id, prompt, provider, dimensions, created_at, thumbnail_b64 (128 px WebP, base64-encoded), content_type, and origin. Pending/generating items include status, progress, and progress_message instead of a thumbnail.

Use browse_gallery to see all images; use show_image(uri="image://{image_id}/view") to view one image at full resolution.

Return a page of image thumbnails for the gallery UI.

App-only helper called by the gallery UI to load additional pages when the user paginates. Not intended for direct model invocation.

Return full-resolution image data for the gallery lightbox.

App-only helper called by the gallery lightbox to load a single image at full (or near-full) resolution. Images larger than 1 MB are downscaled to 1024 px wide WebP before encoding.

List available image generation providers, models, and capabilities.

Returns provider names, available models, and capability details. Each model includes a prompt_style field: use "clip" for comma-separated CLIP tags (SD 1.5/SDXL) or "natural_language" for descriptive sentences (Flux, OpenAI). Each call includes a refreshed_at timestamp. Pass force_refresh=true if providers may have changed since the last check.

Also available as the info://providers resource for clients that support MCP resources.

Open an image for interactive editing (crop, rotate, flip).

The user edits in the viewer UI and saves as a new image. Always edits the original image — resource template transforms are ephemeral and LLM-facing; editor transforms are persistent and user-facing.

Report wrapper and upstream version info for image-generation-mcp. Returns server_name, server_version, core_version (fastmcp-pvl-core), and (when configured) an upstream version block. Useful for verifying a deployment matches the expected build.

List all available resources and resource templates.

Returns JSON with resource metadata. Static resources have a 'uri' field, while templates have a 'uri_template' field with placeholders like {name}.

Read a resource by its URI.

For static resources, provide the exact URI. For templated resources, provide the URI with template parameters filled in.

Returns the resource content as a string. Binary content is base64-encoded.