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 |
Capabilities
Features and capabilities supported by this server
| 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 | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ex-takashima/openAI-gpt-image-1-MCP-SERVER'
If you have feedback or need assistance with the MCP directory API, please join our Discord server