OpenAI GPT-Image MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Set to 1 for detailed logging | |
| OPENAI_API_KEY | Yes | Your OpenAI API key | |
| HISTORY_DB_PATH | No | Custom database location | |
| OPENAI_ORGANIZATION | No | OpenAI organization ID | |
| OPENAI_IMAGE_INPUT_DIR | No | Custom input directory for source images | |
| OPENAI_IMAGE_THUMBNAIL | No | Enable thumbnail generation (true/false) | |
| OPENAI_IMAGE_OUTPUT_DIR | No | Custom output directory for generated images | |
| OPENAI_IMAGE_EMBED_METADATA | No | Enable metadata embedding (true/false) | |
| OPENAI_IMAGE_METADATA_LEVEL | No | Metadata detail level (minimal/standard/full) | |
| OPENAI_IMAGE_THUMBNAIL_SIZE | No | Thumbnail size in pixels | |
| OPENAI_IMAGE_THUMBNAIL_QUALITY | No | Thumbnail JPEG quality |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generate a new image from a text prompt using OpenAI GPT image models. Supports gpt-image-1, gpt-image-1.5 (4x faster/cheaper, better text), and gpt-image-2 (flexible sizes up to 4K). Automatically calculates and reports token usage and cost. |
| edit_imageA | Edit an existing image using inpainting with OpenAI GPT image models. Requires a reference image and optional mask image (transparent areas are edited). gpt-image-1.5 supports input_fidelity for better face/logo preservation. |
| transform_imageB | Transform an existing image to a new style or interpretation using OpenAI GPT image models. Takes a reference image and a prompt describing the desired transformation. gpt-image-1.5 supports input_fidelity for better face/logo preservation. |
| list_generated_imagesB | List all image files in a directory. Shows file names, sizes, and modification dates sorted by newest first. |
| list_historyB | List generation history with optional filters. Shows recent image generation, editing, and transformation operations with their parameters and output files. |
| get_history_by_uuidA | Get detailed information about a specific generation history record by UUID. Shows complete parameters, prompt, and all output files. |
| get_metadata_from_imageA | Extract and display embedded metadata from a generated image file. Shows UUID, parameter hash, generation settings, and verifies integrity with database. Works with PNG and JPEG images that contain embedded OpenAI GPT-Image metadata. |
| start_generation_jobA | Start an async image generation job that runs in the background. Use this for long-running operations or when you want to queue multiple generations. Returns a job ID that can be used to check status and retrieve results. |
| check_job_statusA | Check the status of an async job. Shows current status (pending/running/completed/failed/cancelled) and progress percentage. |
| get_job_resultA | Get the result of a completed async job. Returns output file paths and history UUID. Only works for completed jobs. |
| cancel_jobA | Cancel a pending or running async job. Cannot cancel already completed, failed, or cancelled jobs. |
| list_jobsB | List async jobs with optional filters. Shows job status, progress, creation time, and output information. |
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 12 tools
Each tool targets a distinct operation: image generation, editing, transformation, async job management, history retrieval, and metadata extraction. There is no overlap or ambiguity.
All tool names follow consistent verb_noun snake_case pattern (e.g., generate_image, cancel_job, list_history). No mixing of styles.
12 tools is an appropriate scope for a dedicated image generation server, covering creation, editing, async jobs, and history without being excessive.
Core operations (create, edit, transform, async management, history) are covered. Missing deletion capabilities (e.g., delete_image, delete_history), but these are minor gaps.