MCP server for creating, editing, and combining images with OpenAI models
Single tool 'create_image' has a well-structured schema generated from Zod with proper typing and enums for size/quality/background/model. Description is comprehensive (280+ chars) and explains use cases, parameters, and references documentation. However, parameter descriptions in the schema are minimal (1-2 sentences each), lacking actionable guidance on format, constraints, and dependencies. No output schema is documented, LLMs cannot predict what fields the response contains. Error handling is present but not visible in tool definition. Tool follows verb_noun naming correctly. Overall solid foundation but missing output documentation and richer parameter guidance.
Generates an image using OpenAI (DALL-E 3 / gpt-image-1) based on a detailed text prompt. For best results, provide vivid descriptions incorporating style, composition, lighting, and mood. Can also edit or combine existing images by providing referenceImagePaths. Refer to 'docs/prompt-recipes.md' for extensive examples, templates, and tips for various image types (hero backgrounds, icons, illustrations, photos). Key parameters include 'prompt', 'brandSignature' (use project palette), 'size' (e.g., 1024x1024, 1536x1024), 'quality', 'model', 'filename', 'outputPath', 'targetProjectDir', and 'referenceImagePaths' (for editing/combining images).
Output schema not documented. LLMs cannot predict response structure (e.g., does it return image_url, file_path, dimensions, metadata?). This forces agents to guess and risks failed downstream tool chains.
Parameter descriptions are terse (1-2 sentences). 'styleDefinitionJSON' says 'Optional JSON object defining visual style elements' but does not explain structure, required keys, or valid values. 'referenceImagePaths' lacks guidance on format (relative vs absolute, supported image types).
No documented error recovery guidance. Tool description does not explain what happens on API failures (rate limits, invalid prompts, file write errors) or how to retry. Error handling exists in code but is invisible to LLMs.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Limits deployment to local/containerized environments.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | <=2025-11-25 | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). 'create_image' is destructive (writes files, calls paid API) but lacks annotation to signal this to agents.