MCP server for OpenAI GPT image generation and editing using the gpt-image-1 model
Two tools with complete input schemas and descriptions. Naming follows verb_noun pattern (create-image, edit-image). Descriptions are adequate (100-150 chars) but lack WHEN/WHY guidance. Parameters are well-typed with enums and constraints. Critical gap: no output schema documented, LLMs cannot plan downstream operations. Error handling is minimal; no recovery guidance. File path validation is present but not described in parameter text. Missing tool annotations (destructiveHint for WRITE operations).
Generate images using OpenAI's gpt-image-1 model with customizable parameters for size, quality, format, and background style
Edit existing images using OpenAI's gpt-image-1 model with text prompts describing desired modifications
No output schema documented. LLMs cannot infer what fields are returned (file paths, URLs, metadata, error details). Breaks tool chaining and forces agents to guess downstream parameter types.
Descriptions lack WHEN/WHY context. 'Generate images using OpenAI's gpt-image-1 model...' states WHAT but not WHEN to call this vs alternatives or what prerequisites exist. Descriptions should be 50-200 chars with clear intent guidance.
No error handling guidance. If OpenAI API fails (rate limit, invalid prompt, auth error), the tool returns a raw error. LLMs need actionable recovery hints: 'Rate limited, retry in 60s' or 'Invalid prompt, try shorter text'.
Missing tool annotations. Both tools are destructive (WRITE risk) but lack destructiveHint annotation. Agents cannot distinguish safe (read) from risky (write) operations without explicit hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 69 | 2026-07-28+ | v2 |
File path validation logic is in code but not documented in parameter descriptions. The 'file_output' description should state: 'Must be an absolute path (Unix: /path/to/file.png, Windows: C:\path\to\file.png). If n > 1, index appended.'