Skip to main content
Glama
ex-takashima

OpenAI GPT-Image MCP Server

by ex-takashima

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DEBUGNoSet to 1 for detailed logging
OPENAI_API_KEYYesYour OpenAI API key
HISTORY_DB_PATHNoCustom database location
OPENAI_ORGANIZATIONNoOpenAI organization ID
OPENAI_IMAGE_INPUT_DIRNoCustom input directory for source images
OPENAI_IMAGE_THUMBNAILNoEnable thumbnail generation (true/false)
OPENAI_IMAGE_OUTPUT_DIRNoCustom output directory for generated images
OPENAI_IMAGE_EMBED_METADATANoEnable metadata embedding (true/false)
OPENAI_IMAGE_METADATA_LEVELNoMetadata detail level (minimal/standard/full)
OPENAI_IMAGE_THUMBNAIL_SIZENoThumbnail size in pixels
OPENAI_IMAGE_THUMBNAIL_QUALITYNoThumbnail JPEG quality

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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