openai-images
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IMAGE_MODEL | No | Optional image model to force for this app, overriding the saved default. The value 'latest' is also supported. | |
| OPENAI_API_KEY | No | OpenAI API key. Used if no key is stored in the system credential manager. | |
| IMAGE_OUTPUT_DIR | No | Optional folder where this app's generated images are saved, instead of the configured default folder. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Generates and edits images with OpenAI's Image API. Every image is saved to the user's image folder at full resolution; the chat receives a smaller preview plus the saved path. Use quality 'low' for quick drafts. Each call costs the user money, so don't generate more images than asked for.
Revisions: when the user asks to change an image already made or shared in this conversation ("make the cat black", "now add sunglasses"), call edit_image with the saved path of the most recent version and a prompt that states only the change plus what must stay the same. Don't call generate_image again, which draws a new, different image. Each revision is saved as a new numbered version (-v2, -v3, ...); to undo, edit an earlier version's path. Use generate_image only for a new image or when the user asks to start over.
By default the newest image model is used; list_image_models shows what the user's key can use. To change their saved default, the user runs uv run manage.py model <id> themselves.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generates new images from a text prompt and saves them to the user's image folder. |
| edit_imageA | Revises an existing image, or combines several as references, and saves the result. |
| list_image_modelsA | Lists the OpenAI image models the user's API key can use, newest first. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool targets a clearly distinct action on a distinct resource: create a new image, revise an existing one, or enumerate available models. The descriptions actively steer the agent between them (generate_image explicitly points to edit_image for revisions), removing any realistic misselection risk.
All three tools follow the same verb_noun snake_case pattern (generate_image, edit_image, list_image_models) and share the 'image' resource prefix, making the set predictable and easy to scan.
Three tools is lean but each earns its place, and the parameter surface of generate_image/edit_image carries most of the depth. It sits at the low end of the well-scoped band, with no filler but also no supporting tools such as listing previously saved images.
The core lifecycle (create, revise, and discover models) is fully covered, with versioned saves on edit and mask/reference support. Minor gaps remain around discovering or managing already-saved images (no list/delete/inspect of the output folder) and no image analysis capability.