Codex Image Generation MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEX_HOME | No | Optional startup setting to locate an existing Codex configuration directory | |
| CODEX_IMAGE_PROFILE | No | Optional startup setting to select an existing profile | |
| CODEX_IMAGE_TIMEOUT | No | Upstream timeout in seconds, default 300, must be greater than 0 and no more than 3600 | 300 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_modelsA | List provider dialogue models and recommend a documented image-tool caller. Does not generate images or verify paid tool execution. Image/audio/embedding models are excluded; unclassified provider aliases are returned separately. |
| list_image_modelsA | List image models from official OpenAI docs, independently of provider /models. Requires no provider credentials. Results describe official support, not verified availability through a relay. Stale or bundled fallback catalogs are labeled. |
| generate_imageA | Generate/edit images and save originals in the current directory or requested folder. Reuse Codex relay URL and credentials. Discover dialogue/image models independently; explicit responses_model/image_model values override automatic selection. When the user chooses this MCP, the host can reuse its installed system imagegen skill for prompt preparation and visual review while executing generation here. The server does not load skills itself; skill-specific built-in/CLI settings do not govern this tool. Supports PNG/JPEG/WebP, visual options, reference images and masks. Returns previews, absolute paths and edit IDs; successful images survive partial failures. |
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
generate_image is clearly distinct, but list_models and list_image_models overlap in purpose as model-listing tools. The descriptions do clarify the boundary (dialogue models vs. official image models), reducing but not eliminating the chance of misselection.
All three tools follow a consistent snake_case verb_noun pattern: generate_image, list_models, list_image_models. The convention is predictable and readable throughout.
Three tools is on the lean side but reasonable for a focused image-generation server. Each tool has a clear role, though the two model-listing tools could arguably be consolidated.
The core lifecycle is covered: model discovery plus generation, editing, reference images, masks, and saving originals. Minor gaps exist around post-generation management (e.g., listing or deleting generated images), but typical workflows are supported.